# GET /v3/forms

Form types present (deleted filings excluded) with filing counts, most frequent first. Computed in the background, never by a request: once at start and then every few minutes (5 by default; less often when a computation is slow); computed_at says when, and the list is served until the next computation replaces it. Until the first computation after a start has finished the answer is 503 with code warming_up and Retry-After.

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

**Group:** [Coverage, usage and service](https://www.secblast.com/docs/reference#coverage-usage-and-service)

## Parameters

This route takes no parameters.

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [FormList](https://www.secblast.com/docs/reference/schemas#schema-formlist) (`application/json`) | OK |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
| `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 [FormList](https://www.secblast.com/docs/reference/schemas#schema-formlist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `computed_at` | date-time (RFC 3339, UTC) | no | When the list was computed, UTC. It is served until a later computation replaces it. |
| `data` | array of [FormCount](https://www.secblast.com/docs/reference/schemas#schema-formcount) | yes |   |
| `has_more` | boolean | no |   |
| `next_cursor` | string \| null | no |   |

## Example request

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/forms'
```

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

## More in Coverage, usage and service

Previous: [`GET /v3/coverage/summary`](https://www.secblast.com/docs/reference/get-coverage-summary) · Next: [`GET /v3/health`](https://www.secblast.com/docs/reference/get-health)
