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?
include_serialids boolean Set include_serialids=true to include the Enigma Serial ID field in the row data (default is false). The serial ID is row identifier added by Enigma that is unique within the current snapshot. false
mode string Values: advanced phrase simple
Defaults to simple.
false
phrase_distance integer If mode=phrase, this specifies the proximity search distance. For example, if query=sovereign%20country and phrase_distance=0, the two words must be next to each other. If phrase_distance=1, it also matches 'sovereign island country'. false
query string Query string to return only rows that contain specific information (must set row_limit > 0). 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
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

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'