# Subsidiaries API Reference | SEC API

> Complete API reference for the SEC EDGAR Subsidiary API. Every request parameter, every searchable field and every response attribute of the Exhibit 21 subsidiary lists, with types, constraints and a live example response.

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

Company and governance data

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

Search the current and historical subsidiaries of companies listed on US stock exchanges, from 2003 to present. The dataset holds more than 100,000 subsidiary lists, converted to JSON from Exhibit 21 of 10-K, 10-Q, S-1 and 20-F filings, and new lists are added as soon as EDGAR publishes the filing.

[Read the guide for this API →](https://sec-api.io/docs/subsidiary-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, written as field:value. Every field listed under Searchable fields can be used, combined with AND, OR, NOT, ranges and wildcards.

Example `ticker:AAPL`

from: 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: string, Maximum 50

Number of subsidiary lists to return in one response.

Default `"50"`

sort: array of object

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

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

order: string

Either asc or desc.

## Searchable fields

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

| Field | Description |
| --- | --- |
| `id` | System-internal unique identifier of the list of subsidiaries |
| `accessionNo` | Accession number of the EDGAR filing Exhibit 21 is attached to |
| `filedAt` | Date the list of subsidiaries was disclosed |
| `cik` | CIK of the parent company |
| `ticker` | Ticker symbol of the parent company |
| `companyName` | Name of the parent company |
| `subsidiaries.name` | Name of the subsidiary |
| `subsidiaries.jurisdiction` | Jurisdiction of the subsidiary (state or country) |

## Response

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

total: object

How many subsidiary lists matched the query.

value: integer

Number of matching subsidiary lists.

relation: string

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

data: array of object

The matching subsidiary lists, at most size per response. One item represents one Exhibit 21 disclosed by one parent company in one filing.

id: string

System-internal unique identifier of the list of subsidiaries.

accessionNo: string

Accession number of the EDGAR filing Exhibit 21 is attached to, for example 0000320193-25-000079.

filedAt: string

Date the list of subsidiaries was disclosed, ISO 8601 in Eastern Time, for example 2025-10-31T06:01:26-04:00.

cik: string

CIK of the parent company, leading zeros removed, for example 320193.

ticker: string

Ticker symbol of the parent company, for example AAPL.

companyName: string

Name of the parent company, for example Apple Inc.

subsidiaries: array of object

The subsidiaries of the parent company, as disclosed on this Exhibit 21.

name: string

Name of the subsidiary, for example Apple Canada Inc.

jurisdiction: string

Jurisdiction of the subsidiary, a state or a country, for example Ireland. Empty when the exhibit does not report one.

## Status codes

|  |  |
| --- | --- |
| `200` | Success. The response holds total and data. |
| `400` | The request body could not be parsed, the Lucene expression in query is malformed, or size is above 50. |
| `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/subsidiaries

```json
{
  "query": "ticker:AAPL",
  "from": "0",
  "size": "50",
  "sort": [{ "filedAt": { "order": "desc" } }]
}
```

```python
from sec_api import SubsidiaryApi

subsidiaryApi = SubsidiaryApi("YOUR_API_KEY")

response = subsidiaryApi.get_data({
    "query": "ticker:AAPL",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
})
```

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

subsidiaryApi.setApiKey("YOUR_API_KEY");

const response = await subsidiaryApi.getData({
  query: "ticker:AAPL",
  from: "0",
  size: "50",
  sort: [{ filedAt: { order: "desc" } }],
});
```

```bash
curl -X POST https://api.sec-api.io/subsidiaries \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "ticker:AAPL",
    "from": "0",
    "size": "50",
    "sort": [{ "filedAt": { "order": "desc" } }]
  }'
```

## Response example

200 OK · application/json

```json
{
  "total": {
    "value": 26,
    "relation": "eq"
  },
  "data": [
    {
      "id": "53b6eca92223fed0008eae2e5e2ec8f1",
      "accessionNo": "0000320193-25-000079",
      "filedAt": "2025-10-31T06:01:26-04:00",
      "cik": "320193",
      "ticker": "AAPL",
      "companyName": "Apple Inc.",
      "subsidiaries": [
        {
          "name": "Apple Asia Limited",
          "jurisdiction": "Hong Kong"
        },
        {
          "name": "Apple Asia LLC",
          "jurisdiction": "Delaware, U.S."
        },
        {
          "name": "Apple Canada Inc.",
          "jurisdiction": "Canada"
        },
        {
          "name": "Apple Computer Trading (Shanghai) Co., Ltd.",
          "jurisdiction": "China"
        },
        {
          "name": "Apple Distribution International Limited",
          "jurisdiction": "Ireland"
        },
        {
          "name": "Apple India Private Limited",
          "jurisdiction": "India"
        },
        {
          "name": "Apple Insurance Company, Inc.",
          "jurisdiction": "Arizona, U.S."
        },
        {
          "name": "Apple Japan, Inc.",
          "jurisdiction": "Japan"
        },
        {
          "name": "Apple Korea Limited",
          "jurisdiction": "South Korea"
        },
        {
          "name": "Apple Operations International Limited",
          "jurisdiction": "Ireland"
        },
        {
          "name": "Apple Operations Limited",
          "jurisdiction": "Ireland"
        },
        {
          "name": "Apple Operations Mexico, S.A. de C.V.",
          "jurisdiction": "Mexico"
        },
        {
          "name": "Apple Pty Limited",
          "jurisdiction": "Australia"
        },
        {
          "name": "Apple Services Pte. Ltd.",
          "jurisdiction": "Singapore"
        },
        {
          "name": "Apple South Asia (Thailand) Limited",
          "jurisdiction": "Thailand"
        },
        {
          "name": "Apple South Asia Pte. Ltd.",
          "jurisdiction": "Singapore"
        },
        {
          "name": "Apple Vietnam Limited Liability Company",
          "jurisdiction": "Vietnam"
        },
        {
          "name": "Braeburn Capital, Inc.",
          "jurisdiction": "Nevada, U.S."
        },
        {
          "name": "iTunes K.K.",
          "jurisdiction": "Japan"
        }
      ]
    }
  ]
}
```