# GET /v3/ownership/institutional/holders

The effective 13F rows of one CUSIP across managers for one period (as known at as_of), ordered by manager CIK, ledger step and row; options are their own rows. Matched against the normalised CUSIP as filed; no total. Rows of deleted (SEC-withdrawn) filings are left out; those filings are named in excluded.

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

**Group:** [Institutional holdings (Form 13F)](https://www.secblast.com/docs/reference#institutional-holdings-form-13f)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cusip` | query | string | yes |   | Nine characters of 0-9, A-Z, \*, @, # (trimmed, upper-cased). Required. |
| `period` | query | date (YYYY-MM-DD) | yes |   | The report period, YYYY-MM-DD. Required. |
| `put_call` | query | string | no | `any` | any, none (rows without an option), put, call. One of: `any`, `none`, `put`, `call`. |
| `as_of` | query | string | no |   | Inclusive: YYYY-MM-DDTHH:MM:SSZ (UTC, through the end of that second), YYYY-MM-DDTHH:MM:SS.ffffffZ (exact, 1-6 fraction digits) or YYYY-MM-DD (the whole UTC day). |
| `limit` | query | integer | no | `200` | Page size, 1..1000. |
| `cursor` | query | string | no |   | Opaque cursor from a previous page's next_cursor. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [F13fHolderList](https://www.secblast.com/docs/reference/schemas#schema-f13fholderlist) (`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 [F13fHolderList](https://www.secblast.com/docs/reference/schemas#schema-f13fholderlist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `as_of` | string \| null | no |   |
| `cusip` | string | no |   |
| `data` | array of [F13fHolding](https://www.secblast.com/docs/reference/schemas#schema-f13fholding) + object | no |   |
| `excluded` | [Excluded](https://www.secblast.com/docs/reference/schemas#schema-excluded) | no |   |
| `excluded_total` | integer | no |   |
| `has_more` | boolean | no |   |
| `limits` | [F13fLimits](https://www.secblast.com/docs/reference/schemas#schema-f13flimits) | no |   |
| `next_cursor` | string \| null | no |   |
| `period` | date (YYYY-MM-DD) | no |   |

## Example request

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

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

## More in Institutional holdings (Form 13F)

Previous: [`GET /v3/filings/{accession}/13f/holdings`](https://www.secblast.com/docs/reference/get-filings-accession-13f-holdings) · Next: [`GET /v3/ownership/institutional/managers/{cik}/holdings`](https://www.secblast.com/docs/reference/get-ownership-institutional-managers-cik-holdings)
