Returns the dataset model for the dataset specified by the {dataset_id} parameter.

By default you don’t get any snapshot data. If you set row_limit > 0, the API returns the specified number of data records (rows) from the current snapshot as well (maximum 10,000 rows).

If you specify a query string, the endpoint returns matching rows from the current snapshot, as well as positional information indicating where instances of the specified query string occur (you can use this to highlight text in the search results). You must set row_limit > 0.

Query parameters

NameTypeDescriptionRequired?
row_sort string Specifies the field used to sort the records within the dataset (must set row_limit > 0). If you specify row_offset as well, the records are sorted first and then the offset is applied. Prepend the field name with a minus sign (-) to specify descending order (defaults to ascending). false
mode string Values: advanced simple
Defaults to simple.
false
row_limit integer Number of rows to return (defaults to 0; maximum 10,000). false
row_offset integer Number of rows to skip at the beginning of the snapshot (for example, row_offset=10 skips the first 10 rows). false
query string Query string to return only rows that contain specific information (must set row_limit > 0). false

Try it out

Enter any desired query parameters and click Send to view the response:

GET https://public.enigma.com/api/datasets/{id}?


Responses

CodeReturns
200 The dataset model for the dataset.
422 Unable to serialize entity
500 Elasticsearch response error

Example

This example returns the dataset attributes for the specified dataset (“NASDAQ Stock Exchange”), plus the first two data records from the current snapshot.

$ curl -X GET 'https://public.enigma.com/api/datasets/ebb5e1c4-3780-4524-9d12-6f2a9f6b83b6?&row_limit=2'