# EDGAR Entities API Reference | SEC API

> Complete API reference for the SEC EDGAR Entities Database API. Every request parameter, every searchable field and every response attribute, with types, constraints and a live example response.

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

Identifiers and entities

POST`https://api.sec-api.io/edgar-entities`

Search the master file of every entity that has filed with the SEC through EDGAR since 1994, over 890,000 registrants. Each record carries the CIK, name, addresses, SIC code, filer category, auditor details and every form type the entity has ever filed, together with the timestamp of the last update to each field.

[Read the guide for this API →](https://sec-api.io/docs/edgar-entities-database-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 and NOT, wildcards (*), nested groups in brackets and range queries such as [min TO max].

Example `formTypes.10-K:true AND shellCompany:true`

from: integer or string, Maximum 10000

Index of the first result to return, used for pagination. Increment by the value of size to page through results.

Default `0`

size: integer or string, Maximum 50

Number of entities to return in one response.

Default `50`

sort: array of object

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

Default `[{ "cikUpdatedAt": "desc" }]`

<fieldName>: string

The field to sort by, set to either asc for ascending or desc for descending order.

## 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 |
| --- | --- |
| `cik` | Central Index Key (CIK) — unique EDGAR identifier |
| `name` | Entity legal name |
| `businessAddress.street1` | Business street address line 1 |
| `businessAddress.city` | Business address city |
| `businessAddress.state` | Business address state (2-letter) |
| `businessAddress.zip` | Business address ZIP / postal code |
| `businessAddress.country` | Business address country |
| `mailingAddress.street1` | Mailing street address line 1 |
| `mailingAddress.city` | Mailing address city |
| `mailingAddress.state` | Mailing address state (2-letter) |
| `mailingAddress.zip` | Mailing address ZIP / postal code |
| `stateOfIncorporation` | State of incorporation, e.g. "DE" |
| `sic` | Standard Industrial Classification code, e.g. "3711" |
| `sicLabel` | SIC code with industry label |
| `cfOffice` | SEC Corp Fin office, e.g. "04 Manufacturing" |
| `fiscalYearEnd` | Fiscal year end in MMDD format, e.g. "1231" |
| `irsNo` | IRS / EIN tax identification number |
| `phone` | Phone number |
| `filerCategory` | Filer category — "Large Accelerated Filer", "Accelerated Filer", "Non-accelerated Filer" |
| `wellKnownSeasonedIssuer` | WKSI flag (true/false) |
| `voluntaryFiler` | Voluntary filer flag (true/false) |
| `smallBusiness` | Smaller Reporting Company flag (true/false) |
| `emergingGrowthCompany` | EGC flag (true/false) |
| `shellCompany` | Shell company flag (true/false) |
| `currentReportingStatus` | Current reporting-status flag (true/false) |
| `interactiveDataCurrent` | Interactive data current flag (true/false) |
| `latestIcfrAuditFiledAt` | Date of the latest ICFR auditor attestation |
| `latestIcfrAuditSource` | Accession number of the latest ICFR audit filing |
| `auditorName` | Auditor firm name, e.g. "PricewaterhouseCoopers LLP" |
| `auditorFirmId` | PCAOB-registered auditor firm ID |
| `auditorLocation` | Auditor city / state |
| `formTypes.10-K` | Has filed 10-K (true/false) |
| `formTypes.10-Q` | Has filed 10-Q (true/false) |
| `formTypes.8-K` | Has filed 8-K (true/false) |
| `formTypes.S-1` | Has filed S-1 (true/false) |
| `formTypes.DEF 14A` | Has filed DEF 14A proxy (true/false) |
| `formTypes.SC 13G` | Has filed SC 13G (true/false) |
| `id` | Unique id of the entity record. It carries the same value as cik. |
| `businessAddress.street2` | Second line of the street address, when the filer reports one. |
| `businessAddress.stateName` | Full name of the state, for example TEXAS. |
| `mailingAddress.street2` | Second line of the street address, when the filer reports one. |
| `mailingAddress.stateName` | Full name of the state, for example TEXAS. |
| `mailingAddress.country` | Country, reported for addresses outside the United States. |

## Response

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

total: object

How many entities matched the query.

value: integer

Number of matching entities.

relation: string

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

data: array of object

The matching entities, at most size per response. Every field of an entity object is itself searchable.

id: string

Unique id of the entity record. It carries the same value as cik.

cik: string

Central Index Key of the entity, leading zeros removed, for example 1318605.

name: string

Legal name of the entity.

businessAddress: object

Business address of the entity.

street1: string

First line of the street address, for example 1 TESLA ROAD.

street2: optional string

Second line of the street address, when the filer reports one.

city: string

City, for example AUSTIN.

state: string

Two-letter state code, for example TX.

stateName: optional string

Full name of the state, for example TEXAS.

zip: string

ZIP or postal code.

country: optional string

Country, reported for addresses outside the United States.

mailingAddress: object

Mailing address of the entity.

street1: string

First line of the street address, for example 1 TESLA ROAD.

street2: optional string

Second line of the street address, when the filer reports one.

city: string

City, for example AUSTIN.

state: string

Two-letter state code, for example TX.

stateName: optional string

Full name of the state, for example TEXAS.

zip: string

ZIP or postal code.

country: optional string

Country, reported for addresses outside the United States.

stateOfIncorporation: optional string

State of incorporation of the entity, for example DE for Delaware.

phone: optional string

Phone number of the entity.

irsNo: optional string

Internal Revenue Service tax identification number of the entity, for example 912197729.

fiscalYearEnd: optional string

Month and day marking the end of the fiscal year, MMDD, for example 1231 for 31 December.

sic: optional string

Standard Industrial Classification code of the entity, for example 3711.

sicLabel: optional string

SIC code with its industry label, for example 3711 MOTOR VEHICLES & PASSENGER CAR BODIES.

cfOffice: optional string

Office of the SEC Division of Corporation Finance assigned to the entity, for example 04 Manufacturing.

filerCategory: optional string

Filer category of the entity. Values include Large Accelerated Filer, Accelerated Filer and Non-accelerated Filer.

wellKnownSeasonedIssuer: optional boolean

True if the entity is a well-known seasoned issuer as defined in Rule 405 of the Securities Act.

voluntaryFiler: optional boolean

True if the entity is not required to file.

smallBusiness: optional boolean

True if the entity is a smaller reporting company.

emergingGrowthCompany: optional boolean

True if the entity is an emerging growth company as defined in the Jumpstart Our Business Startups (JOBS) Act.

shellCompany: optional boolean

True if the entity is a shell company as defined in Rule 12b-2 of the Exchange Act.

currentReportingStatus: optional boolean

True if the entity has filed every report required by Section 13 or 15(d) of the Securities Exchange Act of 1934 during the preceding 12 months, or for the shorter period it was required to file, and has been subject to those filing requirements for the past 90 days.

interactiveDataCurrent: optional boolean

True if the entity has submitted every Interactive Data File required by Rule 405 of Regulation S-T during the preceding 12 months, or for the shorter period it was required to submit them.

latestIcfrAuditFiledAt: optional string

Date of the latest auditor attestation of the internal control over financial reporting (ICFR) of the entity, ISO 8601 in Eastern Time.

latestIcfrAuditSource: optional string

Accession number of the filing that carries the latest ICFR auditor attestation.

auditorName: optional string

Name of the auditor of the entity, for example PricewaterhouseCoopers LLP.

auditorFirmId: optional string

PCAOB-registered firm ID of the auditor, for example 238.

auditorLocation: optional string

City and state of the auditor, for example San Jose, California.

formTypes: object

Every form type the entity has filed since it registered with the SEC. Each key is a form type and its value is true, for example { "10-K": true, "10-Q": true }.

<field>UpdatedAt: string

Every field above has a matching timestamp field that records when that field was last updated, ISO 8601 in Eastern Time. For example nameUpdatedAt holds the time of the most recent change to name.

## 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. |

## Request example

POST https://api.sec-api.io/edgar-entities

```json
{
  "query": "cik:1318605",
  "from": 0,
  "size": 50,
  "sort": [{ "cikUpdatedAt": "desc" }]
}
```

```python
from sec_api import EdgarEntitiesApi

edgarEntitiesApi = EdgarEntitiesApi("YOUR_API_KEY")

response = edgarEntitiesApi.get_data({
    "query": "cik:1318605",
    "from": 0,
    "size": 50,
    "sort": [{"cikUpdatedAt": "desc"}],
})

print(response["data"])
```

```javascript
import { edgarEntitiesApi } from "sec-api";

edgarEntitiesApi.setApiKey("YOUR_API_KEY");

const response = await edgarEntitiesApi.getData({
  query: "cik:1318605",
  from: 0,
  size: 50,
  sort: [{ cikUpdatedAt: "desc" }],
});
```

```bash
curl -X POST https://api.sec-api.io/edgar-entities \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "cik:1318605",
    "from": 0,
    "size": 50,
    "sort": [{ "cikUpdatedAt": "desc" }]
  }'
```

## Response example

200 OK · application/json

```json
{
  "total": {
    "value": 1,
    "relation": "eq"
  },
  "data": [
    {
      "id": "1318605",
      "cik": "1318605",
      "cikUpdatedAt": "2026-02-27T19:00:21-05:00",
      "name": "Tesla, Inc.",
      "nameUpdatedAt": "2026-02-27T19:00:21-05:00",
      "businessAddress": {
        "street1": "1 TESLA ROAD",
        "city": "AUSTIN",
        "state": "TX",
        "stateName": "TEXAS",
        "zip": "78725"
      },
      "businessAddressUpdatedAt": "2026-02-27T19:00:21-05:00",
      "mailingAddress": {
        "street1": "1 TESLA ROAD",
        "city": "AUSTIN",
        "state": "TX",
        "stateName": "TEXAS",
        "zip": "78725"
      },
      "mailingAddressUpdatedAt": "2026-02-27T19:00:21-05:00",
      "stateOfIncorporation": "TX",
      "stateOfIncorporationUpdatedAt": "2026-02-27T19:00:21-05:00",
      "phone": "512-516-8177",
      "phoneUpdatedAt": "2026-02-27T19:00:21-05:00",
      "irsNo": "912197729",
      "irsNoUpdatedAt": "2026-02-27T19:00:21-05:00",
      "fiscalYearEnd": "1231",
      "fiscalYearEndUpdatedAt": "2026-02-27T19:00:21-05:00",
      "sic": "3711",
      "sicUpdatedAt": "2026-02-27T19:00:21-05:00",
      "sicLabel": "3711 MOTOR VEHICLES & PASSENGER CAR BODIES",
      "sicLabelUpdatedAt": "2026-02-27T19:00:21-05:00",
      "cfOffice": "04 Manufacturing",
      "cfOfficeUpdatedAt": "2026-02-27T19:00:21-05:00",
      "formTypes": {
        "4": true,
        "144": true,
        "DEFA14A": true,
        "DEF 14A": true,
        "ARS": true,
        "PX14A6G": true,
        "8-K": true,
        "10-Q": true,
        "S-8": true,
        "SCHEDULE 13G/A": true,
        "10-K": true
      },
      "formTypesUpdatedAt": "2026-02-27T19:00:21-05:00",
      "emergingGrowthCompany": false,
      "emergingGrowthCompanyUpdatedAt": "2025-10-02T09:04:54-04:00",
      "currentReportingStatus": true,
      "currentReportingStatusUpdatedAt": "2025-10-22T21:08:43-04:00",
      "interactiveDataCurrent": true,
      "interactiveDataCurrentUpdatedAt": "2025-10-22T21:08:43-04:00",
      "filerCategory": "Large Accelerated Filer",
      "filerCategoryUpdatedAt": "2025-10-22T21:08:43-04:00",
      "smallBusiness": false,
      "smallBusinessUpdatedAt": "2025-10-22T21:08:43-04:00",
      "shellCompany": false,
      "shellCompanyUpdatedAt": "2025-10-22T21:08:43-04:00",
      "auditorLocationUpdatedAt": "2026-01-28T20:55:03-05:00",
      "voluntaryFilerUpdatedAt": "2026-01-28T20:55:03-05:00",
      "auditorNameUpdatedAt": "2026-01-28T20:55:03-05:00",
      "wellKnownSeasonedIssuerUpdatedAt": "2026-01-28T20:55:03-05:00",
      "latestIcfrAuditSource": "0001628280-26-003952",
      "wellKnownSeasonedIssuer": true,
      "voluntaryFiler": false,
      "latestIcfrAuditFiledAt": "2026-01-28T20:55:03-05:00",
      "latestIcfrAuditSourceUpdatedAt": "2026-01-28T20:55:03-05:00",
      "auditorName": "PricewaterhouseCoopers LLP",
      "latestIcfrAuditFiledAtUpdatedAt": "2026-01-28T20:55:03-05:00",
      "auditorFirmId": "238",
      "auditorFirmIdUpdatedAt": "2026-01-28T20:55:03-05:00",
      "auditorLocation": "San Jose, California"
    }
  ]
}
```