GET /v3/datasets
The catalogue of parsed datasets: per dataset its extractor, forms, deployed version, derive steps, tables, status (available or in_preparation), coverage (the first and last filing date of successful results: a range, not a statement that every filing in it is parsed), estimated row counts, when it last changed, and its parse queue. Computed in the background, never by a request (at start, then every few minutes); computed_at says when. Until the first computation after a start the answer is 503 warming_up with Retry-After. Measured accuracy is not published. Cache-Control: public, max-age=300.
API key: not needed.
Group: Datasets
Parameters
This route takes no parameters.
Responses
| Status | Body | Description |
|---|---|---|
200 | DatasetList (application/json) | OK |
503 | Problem (application/problem+json) | Database unavailable (code db_unavailable); or the answer, which the server computes in the background, has not been computed yet since it started (code warming_up). Retry the same request after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a DatasetList object.
| Field | Type | Required | Description |
|---|---|---|---|
computed_at | date-time (RFC 3339, UTC) | yes | |
data | array of Dataset | yes | |
has_more | boolean | yes | |
next_cursor | string | null | yes |
Example request
curl -sS 'https://api.secblast.com/v3/datasets'Open this route in the console
Markdown version: /docs/reference/get-datasets.md