# GET /v3/companies

Companies that are or were SPACs (blank checks, SIC 6770), from the SIC and names in their filing headers over time. spac=former: the de-SPACed companies, newest merger close first (then CIK), each with the close date, the filing it comes from and its basis (item_2_01: the period of report of the completion-of-acquisition 8-K; sic_change: the first filing under the new SIC; name_change: the date the SPAC name was dropped). spac=current: entities whose filings still read SIC 6770, by CIK. The same object is the spac member of /v3/entities/{cik}.

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

**Group:** [Entities](https://www.secblast.com/docs/reference#entities)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `spac` | query | string | no |   | former or current (required). One of: `former`, `current`. |
| `closed_from` | query | date (YYYY-MM-DD) | no |   | spac=former: first merger close date (inclusive), YYYY-MM-DD. |
| `closed_to` | query | date (YYYY-MM-DD) | no |   | spac=former: last merger close date (inclusive), YYYY-MM-DD. |
| `limit` | query | integer | no | `100` | Page size, 1..1000. |
| `cursor` | query | string | no |   | Opaque cursor from a previous page's next_cursor; bound to the filters. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [SpacCompanies](https://www.secblast.com/docs/reference/schemas#schema-spaccompanies) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `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; retry 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 [SpacCompanies](https://www.secblast.com/docs/reference/schemas#schema-spaccompanies) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of object | yes |   |
| `data[].cik` | string | no |   |
| `data[].links` | object | no |   |
| `data[].name` | string \| null | no |   |
| `data[].spac` | [Spac](https://www.secblast.com/docs/reference/schemas#schema-spac) | no |   |
| `has_more` | boolean | yes |   |
| `next_cursor` | string \| null | yes |   |
| `spac` | string | yes | One of: `former`, `current`. |

## Example request

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

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

## More in Entities

Next: [`GET /v3/entities`](https://www.secblast.com/docs/reference/get-entities)
