Ownership and holdings

Manager Cover Pages - Form 13F

POSThttps://api.sec-api.io/form-13f/cover-pages

Search the cover pages of every Form 13F filing. A cover page carries the institutional manager, its address, CIK, CRD and file numbers, the report type, the quarter covered, the number of holdings entries and the total portfolio value.

Read the guide for this API →

Authentication

Send the API key either as a header or as a query parameter. The header is preferred; the query parameter exists for cases where a header cannot be set, such as opening a URL directly in a browser.

Authorization: required header

The API key on its own. Do not prefix it with Bearer or any other word.

Example Authorization: YOUR_API_KEY

token: optional query parameter

The API key, appended to the URL. Use this only when a header is not possible.

Request body

A JSON object. Content-Type must be application/json.

query: required string

The search expression in Lucene syntax. Every field listed under Searchable fields can be used, combined with AND, OR, NOT, ranges and wildcards.

Example crdNumber:105129

from: string, Maximum 10000

Index of the first result to return, used for pagination. Increment by the value of size to page through results. Narrow the query by date range to reach beyond the cap.

Default "0"

size: string, Maximum 50

Number of cover pages to return in one response.

Default "50"

sort: array of object

Sort order. Each item maps one field to an order object, for example [{ "periodOfReport": { "order": "desc" } }].

Default [{ "filedAt": { "order": "desc" } }]

order: string

Either asc or desc.

Searchable fields

Every field below can be used inside query. 43 fields are searchable, and they match the structure of the objects returned in the response.

FieldDescription
accessionNoFiling accession number
cikCIK of the institutional manager
crdNumberCRD number of the manager
secFileNumberSEC file number — e.g. "801-55119"
form13FFileNumber13F-specific file number
formTypeForm type — "13F-HR", "13F-HR/A", "13F-NT"
filedAtFiling acceptance timestamp (ISO 8601)
periodOfReportQuarter-end the filing covers (YYYY-MM-DD)

Response

A JSON object. Nested attributes are collapsed; expand one to see its fields.

total: object

How many cover pages matched the query.

value: integer

Number of matching cover pages, capped at 10000. A value of 10000 with relation gte means more than 10000 cover pages matched.

relation: string

Either eq, meaning value is exact, or gte, meaning value is a floor.

data: array of object

The matching cover pages, at most size per response. Every field of a cover page object is itself searchable.

id: string

Unique identifier of the cover page, for example e8f9f8cf7e111e8608be622357708257.

accessionNo: string

Accession number of the 13F filing, for example 0001398344-24-020966.

filedAt: string

Timestamp EDGAR accepted the filing, ISO 8601 in Eastern Time, for example 2024-11-15T16:37:33-05:00.

formType: string

Form type of the filing: 13F-HR, 13F-HR/A or 13F-NT.

cik: string

CIK of the filing manager, leading zeros removed, for example 1698222.

crdNumber: string

CRD number of the filing manager, for example 104557. Empty when the filer did not report one.

secFileNumber: string

SEC file number of the filing, for example 801-55119. Empty when the filer did not report one.

form13FFileNumber: string

The 13F file number, for example 028-17971.

periodOfReport: string

End of the quarter the filing covers, YYYY-MM-DD, for example 2024-09-30 for the third quarter of 2024.

isAmendment: boolean

True when the filing is an amendment.

reportType: string

Type of report. 13F HOLDINGS REPORT means the manager reports every security under its discretion. 13F NOTICE means another manager reports all of them. 13F COMBINATION REPORT means another manager reports part of them.

provideInfoForInstruction5: boolean

True when the manager provides additional information under Instruction 5 of Form 13F.

additionalInformation: optional string

The free text the manager supplies under Instruction 5. Present when provideInfoForInstruction5 is true.

tableEntryTotal: integer

Total number of holdings entries, for example 521.

tableEntryTotalAsReported: integer

Total number of holdings entries as the manager reported it, for example 521.

tableValueTotal: integer

Total value of the holdings in dollars.

tableValueTotalAsReported: integer

Total value of the holdings in dollars as the manager reported it.

otherIncludedManagersCount: integer

Number of other included managers, for example 1.

Status codes

200Success. The response holds total and data.
400The request body could not be parsed, or the Lucene expression in query is malformed.
403The API key is missing, or it is not valid.
429Too many requests. Slow the request rate and retry.
500Server error. Retry, and report it if it persists.