# API Reference | SEC API

> Complete reference for every SEC-API endpoint. Authentication, request format, pagination and status codes, plus the full parameter and response specification for each API.

Source: https://sec-api.io/api-reference

The complete specification for all 50 endpoints: every parameter, every response field, every type. For task-oriented walkthroughs and worked examples, read the [guides](https://sec-api.io/docs) instead.

## Base URL

Every endpoint lives under one host. The path identifies the API, and the reference page for each endpoint gives its exact URL and method.

`https://api.sec-api.io`

## Authentication

Authenticate every request with your API key, either as an `Authorization` header or as a `token` query parameter. The header is preferred. Do not prefix the key with `Bearer` or any other word. Use the query parameter only where a header cannot be set, such as opening a URL directly in a browser.

```bash
curl -X POST https://api.sec-api.io \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "ticker:TSLA", "from": "0", "size": "10" }'
```

## Request format

Search endpoints take a JSON body in a `POST` request and require `Content-Type: application/json`. Retrieval endpoints, which fetch one known object, take `GET` with the identifier in the URL or query string. Each endpoint page states which it uses.

## Pagination and sorting

Search endpoints page with `from` and `size`. Page by incrementing `from` by the value of `size` until no further results come back.

- `size` returns at most 50 records per response
- `from` reaches 10000, which caps a single query at 10000 records. Split the query by date range to go beyond it
- `total.value` is capped at 10000. A `relation` of `gte` means the true count is higher

The second page of 50 results

```json
{
  "query": "formType:\"10-K\"",
  "from": "50",
  "size": "50",
  "sort": [{ "filedAt": { "order": "desc" } }]
}
```

## Status codes

|  |  |
| --- | --- |
| `200` | Success. The response body holds the result. |
| `400` | The request body could not be parsed, or a search expression is malformed. |
| `403` | The API key is missing or not valid. |
| `404` | The requested object does not exist. |
| `429` | Too many requests. Slow the request rate and retry. |
| `500` | Server error. Retry, and report it if it persists. |

## Endpoints

### Filing search and retrieval

Find filings, then pull their content in whichever form you need: the original file, clean text, a PDF, or parsed XBRL.

[POSTFiling SearchSearch every EDGAR filing since 1993 by ticker, CIK, form type, date and 35 more fields.](https://sec-api.io/api-reference/query-api)[GETEDGAR Ingestion LogDaily publication logs, file index archives and full-content tar archives.](https://sec-api.io/api-reference/edgar-ingestion-log)[POSTFull-Text SearchSearch the body text of every filing and exhibit published since 2001.](https://sec-api.io/api-reference/full-text-search)[GETFile DownloadDownload any EDGAR file exactly as filed: filings, exhibits, XML, images and complete submissions.](https://sec-api.io/api-reference/download-api)[GETPDF GeneratorConvert any filing or exhibit to PDF, preserving formatting, images and tables.](https://sec-api.io/api-reference/pdf-generator)[GETXBRL to JSONConvert the XBRL of a 10-K or 10-Q into standardised financial statements as JSON.](https://sec-api.io/api-reference/xbrl-to-json)[GETItem ExtractorReturn a single item of a 10-K, 10-Q or 8-K as clean text or HTML.](https://sec-api.io/api-reference/extractor)[GETBulk DatasetsBrowse the dataset catalogue, then download complete datasets as monthly archives or one ZIP.](https://sec-api.io/api-reference/bulk-datasets)

### Investment advisers

Form ADV, its schedules, and the individuals behind the firms.

[POSTAdviser FirmsADVRegistered investment adviser firms and their Form ADV disclosures.](https://sec-api.io/api-reference/form-adv)[POSTAdviser RepresentativesADVIndividuals associated with registered investment advisers.](https://sec-api.io/api-reference/form-adv-individuals)[GETDisclosure BrochuresADV Part 2The Part 2 disclosure brochures an adviser files for its clients.](https://sec-api.io/api-reference/form-adv-brochures)[GETDirect OwnersADV Sch ADirect owners and executive officers of the adviser.](https://sec-api.io/api-reference/form-adv-direct-owners)[GETIndirect OwnersADV Sch BIndirect owners of the adviser.](https://sec-api.io/api-reference/form-adv-indirect-owners)[GETOther Business NamesADV D 1.BOther names the adviser conducts business under.](https://sec-api.io/api-reference/form-adv-other-business-names)[GETSeparately Managed AccountsADV D 5.KSeparately managed account holdings and borrowings reported by the adviser.](https://sec-api.io/api-reference/form-adv-separately-managed-accounts)[GETFinancial Industry AffiliationsADV D 7.ARelated financial industry entities the adviser is affiliated with.](https://sec-api.io/api-reference/form-adv-financial-industry-affiliations)[GETPrivate FundsADV D 7.B.1Private funds the adviser advises, with size and type.](https://sec-api.io/api-reference/form-adv-private-funds)

### Ownership and holdings

Who owns what, who is trading it, and which positions crossed a reporting threshold.

[POSTInsider Transactions and Holdings3 / 4 / 5Forms 3, 4 and 5, with the reporting person, the transaction and the price.](https://sec-api.io/api-reference/insider-trading)[POSTRestricted Stock Sales144Notices of proposed sale of restricted and control securities.](https://sec-api.io/api-reference/form-144)[POSTInstitutional Portfolio Holdings13FQuarterly portfolio holdings of institutional investment managers.](https://sec-api.io/api-reference/form-13f-holdings)[POSTManager Cover Pages13FCover page data of Form 13F filings, including the manager and period.](https://sec-api.io/api-reference/form-13f-cover-pages)[POSTBeneficial Ownership Above 5%13D / 13GBeneficial ownership stakes above five percent.](https://sec-api.io/api-reference/form-13d-13g)[POSTFund Portfolio HoldingsN-PORTQuarterly portfolio holdings of registered investment companies.](https://sec-api.io/api-reference/form-nport)

### Investment companies

Annual reports of funds, and how they voted their proxies.

[POSTFund Annual Census ReportsN-CENAnnual reports of registered investment companies.](https://sec-api.io/api-reference/form-ncen)[POSTProxy Voting SearchN-PXProxy voting records filed by funds.](https://sec-api.io/api-reference/form-npx)[GETVoting RecordsN-PXThe individual vote records inside an N-PX filing.](https://sec-api.io/api-reference/form-npx-voting-records)

### Offerings and capital raises

Registered and exempt offerings, from Regulation A and Regulation D through to S-1 prospectuses.

[POSTRegistrations and ProspectusesS-1 / 424B4Registration statements and the prospectuses filed off them.](https://sec-api.io/api-reference/form-s1-424b4)[POSTCrowdfunding OfferingsForm CRegulation Crowdfunding offerings, amendments and annual reports.](https://sec-api.io/api-reference/form-c)[POSTExempt Private OfferingsForm DExempt offerings under Regulation D, as structured JSON.](https://sec-api.io/api-reference/form-d)[POSTAll Filings SearchReg ASearch across all Regulation A offering statements and reports.](https://sec-api.io/api-reference/reg-a-search)[POSTReg A Offering Statements1-ARegulation A offering statements.](https://sec-api.io/api-reference/form-1a)[POSTReg A Annual Reports1-KRegulation A annual reports.](https://sec-api.io/api-reference/form-1k)[POSTReg A Exit Reports1-ZRegulation A exit reports.](https://sec-api.io/api-reference/form-1z)

### Material events

Form 8-K disclosures, one page per item: auditor changes, restatements, and director and officer changes.

[POSTAuditor Changes8-K 4.01Auditor changes, with the former and the new accountant and the reason the engagement ended.](https://sec-api.io/api-reference/form-8k-item-4-01)[POSTFinancial Restatements8-K 4.02Financial restatements and non-reliance disclosures, with the affected periods, line items and auditors.](https://sec-api.io/api-reference/form-8k-item-4-02)[POSTDirector and Officer Changes8-K 5.02Director and officer changes, with the person, the positions and the compensation attached.](https://sec-api.io/api-reference/form-8k-item-5-02)

### Company and governance data

What a company discloses about its people, its auditors, its subsidiaries and its share count.

[POSTExecutive CompensationCompensation of named executives, standardised from DEF 14A filings.](https://sec-api.io/api-reference/executive-compensation)[POSTDirectors and Board MembersCurrent and historical directors, with age, committee membership and qualifications.](https://sec-api.io/api-reference/directors-board-members)[POSTAudit FeesAudit, audit-related, tax and other fees disclosed in DEF 14A filings.](https://sec-api.io/api-reference/audit-fees)[POSTSubsidiariesSubsidiary lists as disclosed in Exhibit 21.](https://sec-api.io/api-reference/subsidiary)[GETShares Outstanding and FloatShares outstanding and public float as reported on filing cover pages.](https://sec-api.io/api-reference/outstanding-shares-float)

### Broker-dealers

FOCUS reports filed by broker-dealers.

[POSTFOCUS ReportsX-17A-5FOCUS reports filed by broker-dealers.](https://sec-api.io/api-reference/form-x-17a-5)

### SEC enforcement and rulemaking

What the Commission has acted on, against whom, and the rule filings of the exchanges it supervises.

[POSTEnforcement ActionsEnforcement actions brought by the SEC.](https://sec-api.io/api-reference/sec-enforcement-actions)[POSTLitigation ReleasesLitigation releases issued by the SEC.](https://sec-api.io/api-reference/sec-litigation-releases)[POSTAdministrative ProceedingsAdministrative proceedings instituted by the SEC.](https://sec-api.io/api-reference/sec-administrative-proceedings)[POSTAAERsAccounting and Auditing Enforcement Releases from 1997 to present.](https://sec-api.io/api-reference/aaer)[POSTSRO FilingsRule filings by self-regulatory organisations.](https://sec-api.io/api-reference/sro-filings)

### Identifiers and entities

Resolve identifiers, and look up the registrants behind the filings.

[GETCIK, CUSIP and Ticker MappingResolve between CIK, CUSIP, ticker and company name.](https://sec-api.io/api-reference/cik-cusip-ticker-lookup)[POSTEDGAR EntitiesEvery registrant that has filed through EDGAR since 1994, with filer category and address.](https://sec-api.io/api-reference/edgar-entities)[GETEDGAR Entity by CIKLook up a single registrant by its CIK.](https://sec-api.io/api-reference/edgar-entity-by-cik)