Ownership and holdings
Manager Cover Pages - Form 13F
https://api.sec-api.io/form-13f/cover-pagesSearch 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.
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.
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.
| Field | Description |
|---|---|
accessionNo | Filing accession number |
cik | CIK of the institutional manager |
crdNumber | CRD number of the manager |
secFileNumber | SEC file number — e.g. "801-55119" |
form13FFileNumber | 13F-specific file number |
formType | Form type — "13F-HR", "13F-HR/A", "13F-NT" |
filedAt | Filing acceptance timestamp (ISO 8601) |
periodOfReport | Quarter-end the filing covers (YYYY-MM-DD) |
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.
amendmentInfo: object
Details of the amendment. An empty object when the filing is not an amendment.
filingManager: object
The institutional manager that filed the report.
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.
otherManagersReportingForThisManager: array of object
Managers that report holdings on behalf of this manager. Empty on a 13F holdings report.
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.
signature: object
The signature block of the filing.
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.
otherIncludedManagers: array of object
Managers whose holdings this filing includes. Empty when the manager reports only its own holdings.
Status codes
200 | Success. The response holds total and data. |
400 | The request body could not be parsed, or the Lucene expression in query is malformed. |
403 | The API key is missing, or it is not valid. |
429 | Too many requests. Slow the request rate and retry. |
500 | Server error. Retry, and report it if it persists. |