Skip to content

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

StatusBodyDescription
200DatasetList (application/json)OK
503Problem (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.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a DatasetList object.

FieldTypeRequiredDescription
computed_atdate-time (RFC 3339, UTC)yes
dataarray of Datasetyes
has_morebooleanyes
next_cursorstring | nullyes

Example request

Shell
curl -sS 'https://api.secblast.com/v3/datasets'

Open this route in the console

Markdown version: /docs/reference/get-datasets.md