# 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](https://www.secblast.com/docs/reference#datasets)

## Parameters

This route takes no parameters.

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [DatasetList](https://www.secblast.com/docs/reference/schemas#schema-datasetlist) (`application/json`) | OK |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [DatasetList](https://www.secblast.com/docs/reference/schemas#schema-datasetlist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `computed_at` | date-time (RFC 3339, UTC) | yes |   |
| `data` | array of [Dataset](https://www.secblast.com/docs/reference/schemas#schema-dataset) | yes |   |
| `has_more` | boolean | yes |   |
| `next_cursor` | string \| null | yes |   |

## Example request

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

[Open this route in the console](https://www.secblast.com/console#get-v3-datasets)
