# XBRL To JSON Converter API - Overview, Introduction

> Convert XBRL data into a standardized JSON format to access financial statements, risk-return summaries and more. All XBRL-friendly SEC filings are supported including 10-K, 10-Q, 8-K and more.

Source: https://sec-api.io/docs/xbrl-to-json-converter-api

Parse and standardize any XBRL data and convert it to standardized JSON format in seconds without coding. Extract financial statements from annual and quarterly reports (10-K, 10-Q, 20-F, 40-F), offerings such as S-1 filings, and post-effective amendements for registration statements (POS AM), accounting policies and footnotes, risk-return summaries of mutual fund and ETF prospectuses (485BPOS) and general information from event filings (8-K). All XBRL-supported filing types can be converterd.

Example: XBRL Income Statement from 10-K Filing in JSON Format

```json
{
  "StatementsOfIncome": {
    "RevenueFromContractWithCustomerExcludingAssessedTax": [
      {
        "decimals": "-6",
        "unitRef": "U_USD",
        "period": {
          "startDate": "2023-07-01",
          "endDate": "2024-06-30"
        },
        "value": "245122000000"
      },
      {
        "decimals": "-6",
        "unitRef": "U_USD",
        "period": {
          "startDate": "2022-07-01",
          "endDate": "2023-06-30"
        },
        "value": "211915000000"
      },
      {
        "decimals": "-6",
        "unitRef": "U_USD",
        "period": {
          "startDate": "2023-07-01",
          "endDate": "2024-06-30"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "64773000000"
      },
      // ... more revenue entries
    ],
    "CostOfGoodsAndServicesSold": [ "..." ],
    "GrossProfit": [ "..." ],
    "ResearchAndDevelopmentExpense": [ "..." ],
    "SellingGeneralAndAdministrativeExpense": [ "..." ],
    "OperatingExpenses": [ "..." ],
    "OperatingIncomeLoss": [ "..." ],
    "NonoperatingIncomeExpense": [ "..." ],
    "IncomeTaxExpenseBenefit": [ "..." ],
    "NetIncomeLoss": [ "..." ],
    "EarningsPerShareBasic": [ "..." ],
    "EarningsPerShareDiluted": [ "..." ],
    "WeightedAverageNumberOfSharesOutstandingBasic": [ "..." ],
    "WeightedAverageNumberOfDilutedSharesOutstanding": [ "..." ]
    // ... more income statement items depending on the company
}
```

The entire US GAAP taxonomy is fully supported. All XBRL items are fully converted into JSON, including `us-gaap`, `dei` and custom items. XBRL facts are automatically mapped to their respective context including period instants and date ranges.

Any XBRL can be directly converted into Python pandas dataframes.

All financial statements and all US GAAP elements are supported, for example:

- Income statement (consolidated statement of operations)
- Balance sheet (consolidated statement of balance sheets)
- Cash flow statement (consolidated statement of cash flows)
- And many more.

**Examples of Income Statement Items**

- RevenueFromContractWithCustomerExcludingAssessedTax
- CostOfGoodsAndServicesSold
- GrossProfit
- ResearchAndDevelopmentExpense
- SellingGeneralAndAdministrativeExpense
- OperatingExpenses
- OperatingIncomeLoss
- NetIncomeLoss
- EarningsPerShareBasic

**Examples of Balance Sheet Items**

- AccountsReceivableNetCurrent
- AccountsPayableCurrent
- LiabilitiesCurrent
- LongTermDebtCurrent
- AssetsNoncurrent
- RetainedEarningsAccumulatedDeficit
- CashAndCashEquivalentsAtCarryingValue
- InventoryNet

You can find a full list of all US-GAAP items authored by the Financial Accounting Standards Board here: [https://www.fasb.org/xbrl](https://www.fasb.org/xbrl)

All cover page items are supported, for example:

- DocumentPeriodEndDate
- EntityFileNumber
- EntityRegistrantName
- EntityIncorporationStateCountryCode
- EntityTaxIdentificationNumber
- Security12bTitle
- TradingSymbol
- SecurityExchangeName
- EntityPublicFloat
- CurrentFiscalYearEndDate

Dataset size:

All XBRL data of any XBRL-friendly filing from 2005 to present.

Data update frequency:

XBRL-JSON data of new filings is available in less than 300 milliseconds after the filing is published on EDGAR.

Survivorship bias free:

Yes. The XBRL to JSON Converter API includes all XBRL data of any XBRL-friendly filing from 2005 to present, from filer entities that are still active and those that are no longer active.

## Supported XBRL Filing Types

The following is a list of all supported filing types categorized by filer type:

Operating Companies:

10-K, 10-K/A, 10-KT, 10-KT/A, 10-Q, 10-Q/A, 10-QT, 10-12B, 10-QT/A, 10-12B/A, 10-12G, 10-12G/A, 8-K, 8-K/A, 8-K12B, 8-K12B/A, 8-K12G3, 8-K12G3/A, 8-K15D5, 8-K15D5/A, 20-F, 20-F/A, 20FR12B, 20FR12B/A, 20FR12G, 20FR12G/A, 40-F, 40-F/A, 40FR12B, 40FR12B/A, 40FR12G, 40FR12G/A, 6-K, 6-K/A, SP 15D2, SP 15D2/A, S-1, S-1/A, S-1MEF, S-3, S-3/A, S-3ASR, S-3D, S-3DPOS, S-3MEF, S-4, S-4/A, S-4EF, S-4MEF, S-4 POS, S-11, S-11/A, S-11MEF, POS AM, POS EX, POSASR, F-1, F-1/A, F-1MEF, F-3, F-3/A, F-3ASR, F-3D, F-3DPOS, F-3MEF, F-4, F-4/A, F-4EF, F-4MEF, F-4 POS, F-10, F-10/A, F-10EF, F-10POS, DEF 14A, DEF 14C, DEFA14A, DEFA14C, DEFC14A, DEFC14C, DEFM14A, DEFM14C, DEFR14A, DEFR14C, PRE 14A, PRE 14C, PREC14A, PREC14C, PREM14A, PREM14C, PRER14A, PRER14C

Attachement type

EX-101.*

Investment Companies:

485BPOS, 487, 497, 485APOS, 485BXT, N-1A, N-1A/A, N-2, N-2/A, N-2ASR, N-2 POSASR, N-2MEF, POS EX, POS462B, POS462C, 486BXT, 486APOS, 486BPOS, 486BXT, POS 8C, POS AMI, 424A, 424B1, 424B2, 424B3, 424B4, 424B5, 424B7, 424B8, N-CSR, N-CSR/A, N-CSRS, N-CSRS/A, SC 13E3, SC 13E3/A, DEF 14A, DEF 14C, DEFA14A, DEFA14C, DEFC14A, DEFM14A, DEFM14C DEFR14A, DEFR14C, 8-K, 8-K/A, 8-K12B, 8-K12B/A, 8-K12G3, 8-K12G3/A, 8-K15D5, 8-K15D5/A, 10-K, 10-K/A, 10-KT, 10-KT/A, 10-Q, 10-Q/A, 10-QT, 10-QT/A, 497, N-3, N-3/A, N-4, N-4/A, N-6, N-6/A, 497J, DEFC14C

Attachement type

EX-101.*

Security-Based Swap Data Repositories:

SDR, SDR/A, SDR-A, SDR-W

Attachement type

EX-99.SDR K.*, EX-99.SDR L.*

## API Endpoint

XML-XBRL data attached to an EDGAR filing can be converted to JSON format by sending a `GET` HTTP request with the XBRL file URL, the HTML filing URL, or the accession number of the filing to the following endpoint:

https://api.sec-api.io/xbrl-to-json

Supported HTTP method: `GET`

Response content type: `JSON`. The response includes all XBRL items in JSON format.

### Authentication

To authenticate requests to the XBRL to JSON Converter API, use the API key shown in your [user profile](https://sec-api.io/login). Utilize the API key in one of two ways. Choose the method that best fits your implementation:

- Set as `Authorization` header. Before making a `GET` request to `https://api.sec-api.io/xbrl-to-json`, set the `Authorization` header to `YOUR_API_KEY`.
- Set as query parameter `?token=YOUR_API_KEY`: Perform a `GET` request to `https://api.sec-api.io/xbrl-to-json?token=YOUR_API_KEY&htm-url=...`.

## Request Parameters

The XBRL-to-JSON Converter API accepts three diferent query parameters for converting XBRL data to JSON. Provide the URL of the filing, the URL of the XBRL file, or the accession number of the filing. Choose the method that best fits your implementation:

1. `htm-url`: Provide the URL of the filing ending with `.htm` or `.html`. Both URLs, to the filing itself and the index page, are accepted.
  **Example URLs:**
  https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231.htm
  https://www.sec.gov/Archives/edgar/data/914243/000091424322000011/0000914243-22-000011-index.html
2. `xbrl-url`: Provide the URL of the XBRL file ending with `.xml`. The XBRL file URL can be found in the `dataFiles` array returned by the [Query API](https://sec-api.io/docs/query-api). The array item always has the `description` EXTRACTED XBRL INSTANCE DOCUMENT.
  **Example URLs:**
  https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231_htm.xml
  https://www.sec.gov/Archives/edgar/data/914243/000091424322000011/ck0000914243-20210930_htm.xml
3. `accession-no`: Provide the accession number of the filing, e.g. `0001564590-21-004599`

Utilize the [Query API](https://sec-api.io/docs/query-api) to generate a list of the most recent 10-K filings that include XBRL files. The search `query` format is as follows and [can be tested in the sandbox](https://sec-api.io/sandbox).

### Request Examples

The following examples demonstrate how to convert XBRL data to JSON using the XBRL-to-JSON Converter API with the three different query parameters: `htm-url`, `xbrl-url`, and `accession-no`.

#### htm-url Example

```bash
https://api.sec-api.io/xbrl-to-json?htm-url=https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231.htm&token=YOUR_API_KEY
```

#### xbrl-url Example

```bash
https://api.sec-api.io/xbrl-to-json?xbrl-url=https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231_htm.xml&token=YOUR_API_KEY
```

#### accession-no Example

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001564590-21-004599&token=YOUR_API_KEY
```

## Response Format

The response represents a JSON object including all financial statements, the cover page and any custom items the company deems important to be published.

Standardized financial statements are:

- StatementsOfIncome
- StatementsOfIncomeParenthetical
- StatementsOfComprehensiveIncome
- StatementsOfComprehensiveIncomeParenthetical
- BalanceSheets
- BalanceSheetsParenthetical
- StatementsOfCashFlows
- StatementsOfCashFlowsParenthetical
- StatementsOfShareholdersEquity
- StatementsOfShareholdersEquityParenthetical

Variants such as *ConsolidatedStatementsofOperations* or *ConsolidatedStatementsOfLossIncome* are automatically renamed to their root name, e.g. *StatementsOfIncome*.

All US GAAP item names are standardized. For example, *us-gaap_SalesRevenueGoodsNet* is renamed to *SalesRevenueGoodsNet* ("*us-gaap_*" was removed). Please note that GAAP items are not renamed to its parent name. For example, *us-gaap_SalesRevenueGoodsNet* is not renamed to *Revenue*. There are many items representing different types of revenue but none of them are renamed to *Revenue* - the original GAAP item name is always maintained.

### Response Structure

- A financial statement is represented as an object.
- An object holds all US GAAP items, for example *RevenueFromContractWithCustomerExcludingAssessedTax*.
- An object key is an array holding all US GAAP item facts. For example, *RevenueFromContractWithCustomerExcludingAssessedTax* is an array where each item represents a revenue value including the period with a start and end date, unit reference (e.g. *USD*) and decimals (e.g. *-6*) indicating that the last 6 digits are rounded.
- The `period` is always an object with `startDate` and `endDate` (e.g. applicable to income statements) or with an `instant` (e.g. applicable to balance sheets).
- The `segment` key (optional) can be an object or array of objects. A `segment` object includes a `dimension` (e.g. *srt:ProductOrServiceAxis*) and a `value` (e.g. *us-gaap:ProductMember*). A `segment` is used to break-down a US GAAP element into more details. For example, a *Revenue* item with the *srt:ProductOrServiceAxis* dimension and *us-gaap:ProductMember* value shows how much revenue was generated with product sales for the given period - excluding service and other sales. Revenues can also be split into geographies (e.g. US, Europe, APAC) or product segments (e.g. iPhone vs Mac sales) using the dimensions.

#### Income Statement - Example Item

JSON

```json
{
  "StatementsOfIncome": {
    "RevenueFromContractWithCustomerExcludingAssessedTax": [
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "value": "274515000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "value": "260174000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "value": "265595000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "220747000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "213883000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "225847000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ServiceMember"
        },
        "value": "53768000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ServiceMember"
        },
        "value": "46291000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ServiceMember"
        },
        "value": "39748000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:IPhoneMember"
        },
        "value": "137781000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:IPhoneMember"
        },
        "value": "142381000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:IPhoneMember"
        },
        "value": "164888000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:MacMember"
        },
        "value": "28622000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:MacMember"
        },
        "value": "25740000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:MacMember"
        },
        "value": "25198000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:IPadMember"
        },
        "value": "23724000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:IPadMember"
        },
        "value": "21280000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:IPadMember"
        },
        "value": "18380000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:WearablesHomeandAccessoriesMember"
        },
        "value": "30620000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:WearablesHomeandAccessoriesMember"
        },
        "value": "24482000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "aapl:WearablesHomeandAccessoriesMember"
        },
        "value": "17381000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:AmericasSegmentMember"
        },
        "value": "124556000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:AmericasSegmentMember"
        },
        "value": "116914000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:AmericasSegmentMember"
        },
        "value": "112093000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:EuropeSegmentMember"
        },
        "value": "68640000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:EuropeSegmentMember"
        },
        "value": "60288000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:EuropeSegmentMember"
        },
        "value": "62420000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:GreaterChinaSegmentMember"
        },
        "value": "40308000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:GreaterChinaSegmentMember"
        },
        "value": "43678000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:GreaterChinaSegmentMember"
        },
        "value": "51942000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:JapanSegmentMember"
        },
        "value": "21418000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:JapanSegmentMember"
        },
        "value": "21506000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:JapanSegmentMember"
        },
        "value": "21733000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:RestOfAsiaPacificSegmentMember"
        },
        "value": "19593000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:RestOfAsiaPacificSegmentMember"
        },
        "value": "17788000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "us-gaap:StatementBusinessSegmentsAxis",
          "value": "aapl:RestOfAsiaPacificSegmentMember"
        },
        "value": "17407000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "country:US"
        },
        "value": "109197000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "country:US"
        },
        "value": "102266000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "country:US"
        },
        "value": "98061000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "country:CN"
        },
        "value": "40308000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "country:CN"
        },
        "value": "43678000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "country:CN"
        },
        "value": "51942000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "aapl:OtherCountriesMember"
        },
        "value": "125010000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "aapl:OtherCountriesMember"
        },
        "value": "114230000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:StatementGeographicalAxis",
          "value": "aapl:OtherCountriesMember"
        },
        "value": "115592000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2020-06-28",
          "endDate": "2020-09-26"
        },
        "value": "64698000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2020-03-29",
          "endDate": "2020-06-27"
        },
        "value": "59685000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-12-29",
          "endDate": "2020-03-28"
        },
        "value": "58313000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2019-12-28"
        },
        "value": "91819000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-06-30",
          "endDate": "2019-09-28"
        },
        "value": "64040000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-03-31",
          "endDate": "2019-06-29"
        },
        "value": "53809000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-12-30",
          "endDate": "2019-03-30"
        },
        "value": "58015000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2018-12-29"
        },
        "value": "84310000000"
      }
    ],
    "CostOfGoodsAndServicesSold": [
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "151286000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "144996000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "148164000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ServiceMember"
        },
        "value": "18273000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ServiceMember"
        },
        "value": "16786000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ServiceMember"
        },
        "value": "15592000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "value": "169559000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "value": "161782000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2017-10-01",
          "endDate": "2018-09-29"
        },
        "value": "163756000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:DerivativeInstrumentRiskAxis",
            "value": "us-gaap:ForeignExchangeContractMember"
          },
          {
            "dimension": "us-gaap:ReclassificationOutOfAccumulatedOtherComprehensiveIncomeAxis",
            "value": "us-gaap:ReclassificationOutOfAccumulatedOtherComprehensiveIncomeMember"
          },
          {
            "dimension": "us-gaap:StatementEquityComponentsAxis",
            "value": "us-gaap:AccumulatedGainLossNetCashFlowHedgeParentMember"
          }
        ],
        "value": "-584000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:DerivativeInstrumentRiskAxis",
            "value": "us-gaap:ForeignExchangeContractMember"
          },
          {
            "dimension": "us-gaap:ReclassificationOutOfAccumulatedOtherComprehensiveIncomeAxis",
            "value": "us-gaap:ReclassificationOutOfAccumulatedOtherComprehensiveIncomeMember"
          },
          {
            "dimension": "us-gaap:StatementEquityComponentsAxis",
            "value": "us-gaap:AccumulatedGainLossNetCashFlowHedgeParentMember"
          }
        ],
        "value": "-482000000"
      }
    ],
    "GrossProfit": [ "..." ],
    "ResearchAndDevelopmentExpense": [ "..." ],
    "SellingGeneralAndAdministrativeExpense": [ "..." ],
    "OperatingExpenses": [ "..." ],
    "OperatingIncomeLoss": [ "..." ],
    "NonoperatingIncomeExpense": [ "..." ],
    "IncomeLossFromContinuingOperationsBeforeIncomeTaxesExtraordinaryItemsNoncontrollingInterest": [ "..." ],
    "IncomeTaxExpenseBenefit": [ "..." ],
    "NetIncomeLoss": [ "..." ],
    "EarningsPerShareBasic": [ "..." ],
    "EarningsPerShareDiluted": [ "..." ],
    "WeightedAverageNumberOfSharesOutstandingBasic": [ "..." ],
    "WeightedAverageNumberOfDilutedSharesOutstanding": [ "..." ]
  }
}
```

#### Balance Sheet - Example Item

JSON

```json
{
  "BalanceSheets": {
    "CashAndCashEquivalentsAtCarryingValue": [
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "value": "38016000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "value": "48844000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:FinancialInstrumentAxis",
          "value": "us-gaap:CashMember"
        },
        "value": "17773000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel1Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:MoneyMarketFundsMember"
          }
        ],
        "value": "2171000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
          "value": "us-gaap:FairValueInputsLevel1Member"
        },
        "value": "2171000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:USTreasurySecuritiesMember"
          }
        ],
        "value": "8580000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:USGovernmentAgenciesDebtSecuritiesMember"
          }
        ],
        "value": "2009000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:ForeignGovernmentDebtSecuritiesMember"
          }
        ],
        "value": "255000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:BankTimeDepositsMember"
          }
        ],
        "value": "4043000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:CommercialPaperMember"
          }
        ],
        "value": "3185000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:CorporateDebtSecuritiesMember"
          }
        ],
        "value": "0"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:USStatesAndPoliticalSubdivisionsMember"
          }
        ],
        "value": "0"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:AssetBackedSecuritiesMember"
          }
        ],
        "value": "0"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
          "value": "us-gaap:FairValueInputsLevel2Member"
        },
        "value": "18072000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:FinancialInstrumentAxis",
          "value": "us-gaap:CashMember"
        },
        "value": "12204000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel1Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:MoneyMarketFundsMember"
          }
        ],
        "value": "15897000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
          "value": "us-gaap:FairValueInputsLevel1Member"
        },
        "value": "15897000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:USTreasurySecuritiesMember"
          }
        ],
        "value": "6165000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:USGovernmentAgenciesDebtSecuritiesMember"
          }
        ],
        "value": "6489000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:ForeignGovernmentDebtSecuritiesMember"
          }
        ],
        "value": "749000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:BankTimeDepositsMember"
          }
        ],
        "value": "2024000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:CommercialPaperMember"
          }
        ],
        "value": "5193000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:CorporateDebtSecuritiesMember"
          }
        ],
        "value": "123000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:USStatesAndPoliticalSubdivisionsMember"
          }
        ],
        "value": "0"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": [
          {
            "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
            "value": "us-gaap:FairValueInputsLevel2Member"
          },
          {
            "dimension": "us-gaap:FinancialInstrumentAxis",
            "value": "us-gaap:AssetBackedSecuritiesMember"
          }
        ],
        "value": "0"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "instant": "2019-09-28"
        },
        "segment": {
          "dimension": "us-gaap:FairValueByFairValueHierarchyLevelAxis",
          "value": "us-gaap:FairValueInputsLevel2Member"
        },
        "value": "20743000000"
      }
    ],
    "MarketableSecuritiesCurrent": [ "..." ],
    "AccountsReceivableNetCurrent": [ "..." ],
    "InventoryNet": [ "..." ],
    "NontradeReceivablesCurrent": [ "..." ],
    "OtherAssetsCurrent": [ "..." ],
    "AssetsCurrent": [ "..." ],
    "MarketableSecuritiesNoncurrent": [ "..." ],
    "PropertyPlantAndEquipmentNet": [ "..." ],
    "OtherAssetsNoncurrent": [ "..." ],
    "AssetsNoncurrent": [ "..." ],
    "Assets": [ "..." ],
    "AccountsPayableCurrent": [ "..." ],
    "OtherLiabilitiesCurrent": [ "..." ],
    "ContractWithCustomerLiabilityCurrent": [ "..." ],
    "CommercialPaper": [ "..." ],
    "LongTermDebtCurrent": [ "..." ],
    "LiabilitiesCurrent": [ "..." ],
    "LongTermDebtNoncurrent": [ "..." ],
    "OtherLiabilitiesNoncurrent": [ "..." ],
    "LiabilitiesNoncurrent": [ "..." ],
    "Liabilities": [ "..." ],
    "CommitmentsAndContingencies": [ "..." ],
    "CommonStocksIncludingAdditionalPaidInCapital": [ "..." ],
    "RetainedEarningsAccumulatedDeficit": [ "..." ],
    "AccumulatedOtherComprehensiveIncomeLossNetOfTax": [ "..." ],
    "StockholdersEquity": [ "..." ],
    "LiabilitiesAndStockholdersEquity": [ "..." ]
  }
}
```

### Response Example

The example shows the JSON version of Apple's 10-K XBRL filing filed on 29/10/2020 (shortened version):
https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926.htm

JSON

```json
{
  "CoverPage": {
    "DocumentType": "10-K",
    "DocumentAnnualReport": "true",
    "DocumentPeriodEndDate": "2020-09-26",
    "DocumentTransitionReport": "false",
    "EntityFileNumber": "001-36743",
    "EntityRegistrantName": "Apple Inc.",
    "EntityIncorporationStateCountryCode": "CA",
    "EntityTaxIdentificationNumber": "94-2404110",
    "EntityAddressAddressLine1": "One Apple Park Way",
    "EntityAddressCityOrTown": "Cupertino",
    "EntityAddressStateOrProvince": "CA",
    "EntityAddressPostalZipCode": "95014",
    "CityAreaCode": "408",
    "LocalPhoneNumber": "996-1010",
    "Security12bTitle": [
      {
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementClassOfStockAxis",
          "value": "us-gaap:CommonStockMember"
        },
        "value": "Common Stock, $0.00001 par value per share"
      },
      {
        "...": "... more items"
      }
    ],
    "TradingSymbol": {
      "period": {
        "startDate": "2019-09-29",
        "endDate": "2020-09-26"
      },
      "segment": {
        "dimension": "us-gaap:StatementClassOfStockAxis",
        "value": "us-gaap:CommonStockMember"
      },
      "value": "AAPL"
    },
    "NoTradingSymbolFlag": [
      {
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementClassOfStockAxis",
          "value": "aapl:A1.000NotesDue2022Member"
        },
        "value": "true"
      },
      {
        "...": "... more items"
      }
    ],
    "SecurityExchangeName": [
      {
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "us-gaap:StatementClassOfStockAxis",
          "value": "us-gaap:CommonStockMember"
        },
        "value": "NASDAQ"
      },
      {
        "...": "... more items"
      }
    ],
    "EntityWellKnownSeasonedIssuer": "Yes",
    "EntityVoluntaryFilers": "No",
    "EntityCurrentReportingStatus": "Yes",
    "EntityInteractiveDataCurrent": "Yes",
    "EntityFilerCategory": "Large Accelerated Filer",
    "EntitySmallBusiness": "false",
    "EntityEmergingGrowthCompany": "false",
    "IcfrAuditorAttestationFlag": "true",
    "EntityShellCompany": "false",
    "EntityPublicFloat": {
      "decimals": "-6",
      "unitRef": "usd",
      "period": {
        "instant": "2020-03-27"
      },
      "value": "1070633000000"
    },
    "EntityCommonStockSharesOutstanding": {
      "decimals": "-3",
      "unitRef": "shares",
      "period": {
        "instant": "2020-10-16"
      },
      "value": "17001802000"
    },
    "AmendmentFlag": "false",
    "DocumentFiscalYearFocus": "2020",
    "DocumentFiscalPeriodFocus": "FY",
    "EntityCentralIndexKey": "0000320193",
    "CurrentFiscalYearEndDate": "--09-26"
  },
  "StatementsOfIncome": {
    "RevenueFromContractWithCustomerExcludingAssessedTax": [
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2019-09-29",
          "endDate": "2020-09-26"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "220747000000"
      },
      {
        "decimals": "-6",
        "unitRef": "usd",
        "period": {
          "startDate": "2018-09-30",
          "endDate": "2019-09-28"
        },
        "segment": {
          "dimension": "srt:ProductOrServiceAxis",
          "value": "us-gaap:ProductMember"
        },
        "value": "213883000000"
      },
      "... more items"
    ],
    "CostOfGoodsAndServicesSold": [ "..." ],
    "GrossProfit": [ "..." ],
    "ResearchAndDevelopmentExpense": [ "..." ],
    "SellingGeneralAndAdministrativeExpense": [ "..." ],
    "OperatingExpenses": [ "..." ],
    "OperatingIncomeLoss": [ "..." ],
    "NonoperatingIncomeExpense": [ "..." ],
    "IncomeLossFromContinuingOperationsBeforeIncomeTaxesExtraordinaryItemsNoncontrollingInterest": [ "..." ],
    "IncomeTaxExpenseBenefit": [ "..." ],
    "NetIncomeLoss": [ "..." ],
    "EarningsPerShareBasic": [ "..." ],
    "EarningsPerShareDiluted": [ "..." ],
    "WeightedAverageNumberOfSharesOutstandingBasic": [ "..." ],
    "WeightedAverageNumberOfDilutedSharesOutstanding": [ "..." ]
  },
  "StatementsOfComprehensiveIncome": {
    "NetIncomeLoss": [ "..." ],
    "OtherComprehensiveIncomeLossForeignCurrencyTransactionAndTranslationAdjustmentNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeLossDerivativeInstrumentGainLossbeforeReclassificationafterTax": {
      "decimals": "-6",
      "unitRef": "usd",
      "period": {
        "startDate": "2019-09-29",
        "endDate": "2020-09-26"
      },
      "value": "79000000"
    },
    "OtherComprehensiveIncomeUnrealizedGainLossOnDerivativesArisingDuringPeriodNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeLossCashFlowHedgeGainLossReclassificationAfterTax": { "...": "..." },
    "OtherComprehensiveIncomeLossReclassificationAdjustmentFromAOCIOnDerivativesNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeLossDerivativeInstrumentGainLossafterReclassificationandTax": { "...": "..." },
    "OtherComprehensiveIncomeLossDerivativesQualifyingAsHedgesNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeUnrealizedHoldingGainLossOnSecuritiesArisingDuringPeriodNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeLossReclassificationAdjustmentFromAOCIForSaleOfSecuritiesNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeLossAvailableForSaleSecuritiesAdjustmentNetOfTax": [ "..." ],
    "OtherComprehensiveIncomeLossNetOfTaxPortionAttributableToParent": [ "..." ],
    "ComprehensiveIncomeNetOfTax": [ "..." ]
  },
  "BalanceSheets": {
    "CashAndCashEquivalentsAtCarryingValue": [ "..." ],
    "MarketableSecuritiesCurrent": [ "..." ],
    "AccountsReceivableNetCurrent": [ "..." ],
    "InventoryNet": [ "..." ],
    "NontradeReceivablesCurrent": [ "..." ],
    "OtherAssetsCurrent": [ "..." ],
    "AssetsCurrent": [ "..." ],
    "MarketableSecuritiesNoncurrent": [ "..." ],
    "PropertyPlantAndEquipmentNet": [ "..." ],
    "OtherAssetsNoncurrent": [ "..." ],
    "AssetsNoncurrent": [ "..." ],
    "Assets": [ "..." ],
    "AccountsPayableCurrent": [ "..." ],
    "OtherLiabilitiesCurrent": [ "..." ],
    "ContractWithCustomerLiabilityCurrent": [ "..." ],
    "CommercialPaper": [ "..." ],
    "LongTermDebtCurrent": [ "..." ],
    "LiabilitiesCurrent": [ "..." ],
    "LongTermDebtNoncurrent": [ "..." ],
    "OtherLiabilitiesNoncurrent": [ "..." ],
    "LiabilitiesNoncurrent": [ "..." ],
    "Liabilities": [ "..." ],
    "CommitmentsAndContingencies": [ "..." ],
    "CommonStocksIncludingAdditionalPaidInCapital": [ "..." ],
    "RetainedEarningsAccumulatedDeficit": [ "..." ],
    "AccumulatedOtherComprehensiveIncomeLossNetOfTax": [ "..." ],
    "StockholdersEquity": [ "..." ],
    "LiabilitiesAndStockholdersEquity": [ "..." ]
  },
  "BalanceSheetsParenthetical": {
    "CommonStockParOrStatedValuePerShare": [ "..." ],
    "CommonStockSharesAuthorized": [ "..." ],
    "CommonStockSharesIssued": [ "..." ],
    "CommonStockSharesOutstanding": [ "..." ]
  },
  "StatementsOfShareholdersEquity": {
    "StockholdersEquity": [ "..." ],
    "StockIssuedDuringPeriodValueNewIssues": [ "..." ],
    "AdjustmentsRelatedToTaxWithholdingForShareBasedCompensation": [ "..." ],
    "AdjustmentsToAdditionalPaidInCapitalSharebasedCompensationRequisiteServicePeriodRecognitionValue": [ "..." ],
    "NetIncomeLoss": [ "..." ],
    "Dividends": [ "..." ],
    "StockRepurchasedAndRetiredDuringPeriodValue": [ "..." ],
    "OtherComprehensiveIncomeLossNetOfTaxPortionAttributableToParent": [ "..." ],
    "CommonStockDividendsPerShareDeclared": [ "..." ]
  },
  "StatementsOfCashFlows": {
    "CashCashEquivalentsRestrictedCashAndRestrictedCashEquivalents": [ "..." ],
    "NetIncomeLoss": [ "..." ],
    "DepreciationDepletionAndAmortization": [ "..." ],
    "ShareBasedCompensation": [ "..." ],
    "DeferredIncomeTaxExpenseBenefit": [ "..." ],
    "OtherNoncashIncomeExpense": [ "..." ],
    "IncreaseDecreaseInAccountsReceivable": [ "..." ],
    "IncreaseDecreaseInInventories": [ "..." ],
    "IncreaseDecreaseInOtherReceivables": [ "..." ],
    "IncreaseDecreaseInOtherOperatingAssets": [ "..." ],
    "IncreaseDecreaseInAccountsPayable": [ "..." ],
    "IncreaseDecreaseInContractWithCustomerLiability": [ "..." ],
    "IncreaseDecreaseInOtherOperatingLiabilities": [ "..." ],
    "NetCashProvidedByUsedInOperatingActivities": [ "..." ],
    "PaymentsToAcquireAvailableForSaleSecuritiesDebt": [ "..." ],
    "ProceedsFromMaturitiesPrepaymentsAndCallsOfAvailableForSaleSecurities": [ "..." ],
    "ProceedsFromSaleOfAvailableForSaleSecuritiesDebt": [ "..." ],
    "PaymentsToAcquirePropertyPlantAndEquipment": [ "..." ],
    "PaymentsToAcquireBusinessesNetOfCashAcquired": [ "..." ],
    "PaymentsToAcquireOtherInvestments": [ "..." ],
    "ProceedsFromSaleAndMaturityOfOtherInvestments": [ "..." ],
    "PaymentsForProceedsFromOtherInvestingActivities": [ "..." ],
    "NetCashProvidedByUsedInInvestingActivities": [ "..." ],
    "ProceedsFromIssuanceOfCommonStock": [ "..." ],
    "PaymentsRelatedToTaxWithholdingForShareBasedCompensation": [ "..." ],
    "PaymentsOfDividends": [ "..." ],
    "PaymentsForRepurchaseOfCommonStock": [ "..." ],
    "ProceedsFromIssuanceOfLongTermDebt": [ "..." ],
    "RepaymentsOfLongTermDebt": [ "..." ],
    "ProceedsFromRepaymentsOfCommercialPaper": [ "..." ],
    "ProceedsFromPaymentsForOtherFinancingActivities": [ "..." ],
    "NetCashProvidedByUsedInFinancingActivities": [ "..." ],
    "CashCashEquivalentsRestrictedCashAndRestrictedCashEquivalentsPeriodIncreaseDecreaseIncludingExchangeRateEffect": [ "..." ],
    "IncomeTaxesPaidNet": [ "..." ],
    "InterestPaidNet": [ "..." ]
  },
  "SummaryofSignificantAccountingPolicies": {
    "BasisOfPresentationAndSignificantAccountingPoliciesTextBlock": "Summary of Significant Accounting Policies<div style=\"margin-top:9pt;text-align:justify\"><span style"
  },
  "SummaryofSignificantAccountingPoliciesPolicies": {
    "BasisOfAccountingPolicyPolicyTextBlock": "...",
    "FiscalPeriod": "...",
    "StockSplitPolicyPolicyTextBlock": "...",
    "NewAccountingPronouncementsPolicyPolicyTextBlock": "...",
    "AdvertisingCostsPolicyTextBlock": "...",
    "CompensationRelatedCostsPolicyTextBlock": "...",
    "EarningsPerSharePolicyTextBlock": "...",
    "CashAndCashEquivalentsPolicyTextBlock": "...",
    "InventoryPolicyTextBlock": "...",
    "PropertyPlantAndEquipmentPolicyTextBlock": "...",
    "EquitySecuritiesWithoutReadilyDeterminableFairValuePolicyTextBlock": "...",
    "RestrictedCashandRestrictedMarketableSecuritiesPolicyTextBlock": "...",
    "FairValueMeasurementPolicyPolicyTextBlock": "...",
    "RevenueRecognitionPolicyTextBlock": "...",
    "DerivativesPolicyTextBlock": "...",
    "IncomeTaxPolicyTextBlock": "...",
    "SegmentReportingPolicyPolicyTextBlock": "...",
    "LesseeLeasesPolicyTextBlock": "..."
  },
  "SummaryofSignificantAccountingPoliciesTables": {
    "ScheduleOfEarningsPerShareBasicAndDilutedTableTextBlock": "..."
  },
  "SummaryofSignificantAccountingPoliciesAdditionalInformationDetails": {
    "StockholdersEquityNoteStockSplitConversionRatio1": { "...": "..." },
    "OperatingandFinanceLeaseRightofUseAsset": [ "..." ],
    "OperatingandFinanceLeaseLiability": [ "..." ],
    "StockholdersEquity": [ "..." ],
    "AntidilutiveSecuritiesExcludedFromComputationOfEarningsPerShareAmount": { "...": "..." },
    "PropertyPlantAndEquipmentUsefulLife": [ "..." ],
    "Depreciation": [ "..." ],
    "NonCashActivitiesInvolvingPropertyPlantandEquipmentNetIncreaseDecreasetoAccountsPayableandOtherCurrentLiabilities": [ "..." ]
  },
  "SummaryofSignificantAccountingPoliciesComputationofBasicandDilutedEarningsPerShareDetails": {
    "NetIncomeLoss": [ "..." ],
    "WeightedAverageNumberOfSharesOutstandingBasic": [ "..." ],
    "WeightedAverageNumberDilutedSharesOutstandingAdjustment": [ "..." ],
    "WeightedAverageNumberOfDilutedSharesOutstanding": [ "..." ],
    "EarningsPerShareBasic": [ "..." ],
    "EarningsPerShareDiluted": [ "..." ]
  },
  "RevenueRecognition": {
    "RevenueFromContractWithCustomerTextBlock": "..."
  },
  "RevenueRecognitionTables": {
    "DisaggregationOfRevenueTableTextBlock": "..."
  },
  "RevenueRecognitionAdditionalInformationDetails": {
    "PerformanceObligationsinArrangements": { "...": "..." },
    "ContractWithCustomerLiability": [ "..." ]
  },
  "RevenueRecognitionDeferredRevenueExpectedTimingofRealizationDetails": {
    "RevenueRemainingPerformanceObligationPercentage": [ "..." ],
    "RevenueRemainingPerformanceObligationExpectedTimingOfSatisfactionPeriod1": [ "..." ]
  },
  "RevenueRecognitionNetSalesDisaggregatedbySignificantProductsandServicesDetails": {
    "RevenueFromContractWithCustomerExcludingAssessedTax": [ "..." ],
    "ContractWithCustomerLiabilityRevenueRecognized": [ "..." ]
  },
  "FinancialInstruments": {
    "FinancialInstrumentsDisclosureTextBlock": "..."
  },
  "FinancialInstrumentsTables": {
    "ScheduleOfCashCashEquivalentsAndShortTermInvestmentsTableTextBlock": "...",
    "ScheduleOfRestrictedCashAndCashEquivalentsTextBlock": "...",
    "ScheduleOfDerivativeInstrumentsInStatementOfFinancialPositionFairValueTextBlock": "...",
    "ScheduleOfDerivativeInstrumentsGainLossInStatementOfFinancialPerformanceTextBlock": "...",
    "ScheduleOfFairValueHedgingInstrumentsStatementsOfFinancialPerformanceAndFinancialPositionLocationTableTextBlock": "...",
    "NotionalAndCreditRiskAmountsOfOutstandingDerivativePositionsDisclosureTableTextBlock": "..."
  },
  "FinancialInstrumentsCashCashEquivalentsandMarketableSecuritiesDetails": {
    "AvailableForSaleDebtSecuritiesAmortizedCostBasis": [ "..." ],
    "AvailableForSaleDebtSecuritiesAccumulatedGrossUnrealizedGainBeforeTax": [ "..." ],
    "AvailableForSaleDebtSecuritiesAccumulatedGrossUnrealizedLossBeforeTax": [ "..." ],
    "AvailableForSaleSecuritiesDebtSecurities": [ "..." ],
    "CashAndCashEquivalentsAtCarryingValue": [ "..." ],
    "MarketableSecuritiesCurrent": [ "..." ],
    "MarketableSecuritiesNoncurrent": [ "..." ],
    "RestrictedInvestments": [ "..." ]
  },
  "...": "... more items"
}
```

## FAQ

Common questions about querying the XBRL to JSON Converter API, the response shape, and the bulk archives.

### How do I pull a company's annual revenue, net income, and EPS straight from its 10-K filing without scraping the HTML?

Send the 10-K to the `/xbrl-to-json` endpoint and pull the figures out of the standardized income statement object. The endpoint accepts the SEC filing URL (`htm-url`), the XBRL instance URL (`xbrl-url`), or the accession number (`accession-no`), and returns one JSON document containing every XBRL fact in the filing.

Annual revenue is reported under the income statement object (`StatementsOfIncome.RevenueFromContractWithCustomerExcludingAssessedTax`), net income under `StatementsOfIncome.NetIncomeLoss`, and earnings per share under `StatementsOfIncome.EarningsPerShareBasic` and `StatementsOfIncome.EarningsPerShareDiluted`. Each of these is an array, where every entry carries a `value` together with `period.startDate` and `period.endDate`. To get the full-year figure, pick the entry whose period spans roughly twelve months and that has no `segment` key — that is the consolidated total.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I convert an XBRL filing to JSON when I only have the SEC accession number?

Call the `/xbrl-to-json` endpoint with the `accession-no` parameter set to the dashed accession number, for example `0001564590-21-004599`. The converter looks up the matching XBRL instance document on EDGAR and returns the same JSON structure it would produce for a direct `htm-url` or `xbrl-url` input, so no other identifier is needed.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001564590-21-004599&token=YOUR_API_KEY
```

### How do I authenticate calls to the XBRL converter — can I use a header instead of a query string?

The `/xbrl-to-json` endpoint accepts the API key in two equivalent ways. The key can be set as the value of an `Authorization` header, or it can be carried on the URL itself as `?token=YOUR_API_KEY`. Either form authenticates the same call, so the header path is available whenever a URL-embedded secret is undesirable.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001564590-21-004599&token=YOUR_API_KEY
```

### How do I get the JSON for a filing when all I have is the SEC's HTML filing page URL or its index page URL?

Provide the URL to the `/xbrl-to-json` endpoint as the `htm-url` parameter. The parameter accepts both the URL of the primary filing document ending in `.htm` (for example `tsla-10k_20201231.htm`) and the URL of the EDGAR filing index page ending in `-index.html`. Either form is resolved to the underlying XBRL instance document and returned as the same JSON response.

```bash
https://api.sec-api.io/xbrl-to-json?htm-url=https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231.htm&token=YOUR_API_KEY
```

### How do I extract Apple's iPhone revenue versus Mac revenue versus Services revenue for a given fiscal year?

Convert Apple's 10-K with the `/xbrl-to-json` endpoint and walk the revenue array on the income statement (`StatementsOfIncome.RevenueFromContractWithCustomerExcludingAssessedTax`). Product-line breakdowns are tagged with a segment whose dimension is the product-or-service axis — the value of `segment.dimension` is `srt:ProductOrServiceAxis` — and the entry's `segment.value` identifies the product. iPhone revenue appears where `segment.value` is `aapl:IPhoneMember`, Mac revenue where it is `aapl:MacMember`, and Services revenue where it is `us-gaap:ServiceMember`. iPad and wearables sit alongside under `aapl:IPadMember` and `aapl:WearablesHomeandAccessoriesMember`.

To isolate a single fiscal year, additionally restrict to the entries whose `period.startDate` and `period.endDate` span that year — for fiscal 2020 the period runs from `2019-09-29` to `2020-09-26`. The reported amounts use a `unitRef` of `usd` and a `decimals` of `-6`, meaning the last six digits are rounded to whole units of dollars.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I break a company's revenue down by geography (US, China, Europe, Japan) for trend analysis?

Convert the filing with `/xbrl-to-json` and pick the revenue entries on the income statement (`StatementsOfIncome.RevenueFromContractWithCustomerExcludingAssessedTax`) whose `segment.dimension` is the geographic axis `srt:StatementGeographicalAxis` or the business-segments axis `us-gaap:StatementBusinessSegmentsAxis`. The `segment.value` identifies the region: country codes such as `country:US` and `country:CN` on the geographical axis, and registrant-defined members such as `aapl:AmericasSegmentMember`, `aapl:EuropeSegmentMember`, `aapl:GreaterChinaSegmentMember`, and `aapl:JapanSegmentMember` on the segments axis.

To build a trend, repeat the conversion for each year's 10-K and group entries by `segment.value`, using `period.startDate` and `period.endDate` to align them on the same fiscal calendar.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I tell which revenue figure is the consolidated total and which ones are sub-segments?

In the JSON returned by `/xbrl-to-json`, every fact on a financial-statement object is an array entry that may or may not carry a `segment` key. The consolidated total for a given period is the entry that has no `segment` at all — only `period`, `unitRef`, `decimals`, and `value`. Entries that include a `segment` object (or a `segment` array of dimension/value pairs) are slices of the total along axes such as product, geography, or business segment, and should not be added to the total. Filter on the presence of `segment` to keep totals and breakdowns separate.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I compute quarterly revenue when the filing reports both annual and quarterly periods together?

After converting the filing with `/xbrl-to-json`, walk the revenue array on the income statement (`StatementsOfIncome.RevenueFromContractWithCustomerExcludingAssessedTax`) and filter by the duration of each entry's period. The difference between `period.endDate` and `period.startDate` is roughly twelve months for annual entries, three months for quarterly entries, and three or six or nine months for year-to-date entries. Keep only the entries whose duration is around three months to isolate quarterly figures, and discard `segment`-bearing entries if a single consolidated quarter is desired.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000062&token=YOUR_API_KEY
```

### How do I get a point-in-time balance sheet value such as cash on hand at quarter-end?

Convert the filing with `/xbrl-to-json` and read the balance-sheet object (`BalanceSheets`). Balance-sheet items such as cash (`BalanceSheets.CashAndCashEquivalentsAtCarryingValue`) are arrays whose entries use a point-in-time period rather than a date range: each entry has `period.instant` set to the balance-sheet date (for example `2020-09-26`) instead of `period.startDate` and `period.endDate`. Pick the entry whose `period.instant` matches the quarter-end and that carries no `segment` key to get the consolidated cash balance on that date.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I find the latest 10-K filings that actually have XBRL data attached so I can feed them into the converter?

Use the Filing Query API at `/query-api` to list 10-K filings that carry an XBRL instance document, then hand each result off to `/xbrl-to-json`. The search restricts the form type to `10-K` and requires the `dataFiles` array to contain an item whose `description` is `XBRL INSTANCE DOCUMENT`; sort the results by filing date descending to get the most recent filings first.

Each returned filing includes an `accessionNo` that can be fed straight into `/xbrl-to-json` as the `accession-no` parameter, or its `dataFiles` entry for the XBRL instance can be fed as `xbrl-url`.

```json
{
  "query": "formType:\"10-K\" AND dataFiles.description:\"XBRL INSTANCE DOCUMENT\"",
  "from": 0,
  "size": 50,
  "sort": [{"filedAt":{"order":"desc"}}]
}
```

### How do I locate the XBRL instance document URL for a filing returned by the Query API?

On each filing object returned by `/query-api`, look through the `dataFiles` array for the entry whose `description` is `EXTRACTED XBRL INSTANCE DOCUMENT`. That entry's URL points to the `.xml` instance document on EDGAR and is the value to use as the `xbrl-url` input to `/xbrl-to-json`. Filings without such a `dataFiles` entry are not XBRL-tagged and cannot be converted.

```json
{
  "query": "formType:\"10-K\" AND dataFiles.description:\"EXTRACTED XBRL INSTANCE DOCUMENT\"",
  "from": 0,
  "size": 50,
  "sort": [{"filedAt":{"order":"desc"}}]
}
```

### How do I extract a company's ticker symbol, exchange listing, and SEC central index key from its annual report?

Convert the 10-K with `/xbrl-to-json` and read three fields on the cover-page object. The ticker is reported on `CoverPage.TradingSymbol` (for example `AAPL`), the exchange listing on `CoverPage.SecurityExchangeName` (for example `NASDAQ`), and the SEC central index key on `CoverPage.EntityCentralIndexKey` (for example `0000320193`). When a company has multiple classes of securities, `TradingSymbol` and `SecurityExchangeName` become arrays whose entries carry a `segment` that identifies the class via the class-of-stock axis `us-gaap:StatementClassOfStockAxis`.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I determine the fiscal year and fiscal period that a filing covers?

After converting the filing with `/xbrl-to-json`, read the three fiscal-period fields on the cover-page object. The fiscal year is on `CoverPage.DocumentFiscalYearFocus` (for example `2020`), the fiscal-period code is on `CoverPage.DocumentFiscalPeriodFocus` (`FY` for annual reports, and `Q1`, `Q2`, or `Q3` for quarterly ones), and the last day of the period is on `CoverPage.DocumentPeriodEndDate` (for example `2020-09-26`).

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I tell if a filing is an amendment to a previously filed report?

After converting the filing with `/xbrl-to-json`, check the amendment flag on the cover-page object: the value of `CoverPage.AmendmentFlag` should be `true` for an amendment and `false` otherwise. The document-type field corroborates this — amended forms carry the `/A` suffix on `CoverPage.DocumentType` (for example `10-K/A`, `10-Q/A`, or `20-F/A`), and the converter handles all of these amended variants the same way it handles the originals.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001564590-19-003165&token=YOUR_API_KEY
```

### How do I read the reported value correctly when XBRL says decimals is -6 — does that mean the figure is already in millions?

In the JSON returned by `/xbrl-to-json`, the `value` on every fact is always the raw figure in full units (dollars or shares), not a scaled number. The `decimals` attribute only tells the reader how many digits at the end of the number are rounded: a `decimals` of `-6` means the last six digits are rounded, so a value of `245122000000` should be read as approximately 245.122 billion dollars rather than as 245,122 of anything. To present the figure in millions, divide by one million in the consumer code; do not interpret a `decimals` of `-6` as the value already being in millions.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I confirm the currency of a reported amount before comparing numbers across foreign issuers?

Every fact returned by `/xbrl-to-json` carries a unit reference on the `unitRef` field that identifies what the `value` is measured in. Monetary amounts use a currency code such as `usd`, while share counts use `shares` (as on `CoverPage.EntityCommonStockSharesOutstanding`). Before comparing two issuers' numbers, confirm that both facts share the same `unitRef`; foreign filers reporting in other currencies will carry a different code and need to be converted before they can be compared on a like-for-like basis.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I pull cash flow from operations, investing, and financing for a DCF model?

Convert the 10-K with `/xbrl-to-json` and read three fields on the cash-flow object (`StatementsOfCashFlows`). Operating cash flow is on `StatementsOfCashFlows.NetCashProvidedByUsedInOperatingActivities`, investing cash flow on `StatementsOfCashFlows.NetCashProvidedByUsedInInvestingActivities`, and financing cash flow on `StatementsOfCashFlows.NetCashProvidedByUsedInFinancingActivities`. Each is an array of period entries; keep the entry whose `period.startDate` to `period.endDate` covers the full fiscal year and that has no `segment` to get the consolidated annual total for the DCF base.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I get a company's diluted earnings per share and weighted average diluted share count for valuation work?

After converting the filing with `/xbrl-to-json`, read two fields on the income-statement object. Diluted earnings per share are on `StatementsOfIncome.EarningsPerShareDiluted`, and the matching weighted-average diluted share count is on `StatementsOfIncome.WeightedAverageNumberOfDilutedSharesOutstanding`. Both are arrays of period entries — match them by `period.startDate` and `period.endDate` so the EPS and share count come from the same period, and check `unitRef` (`usd` per share for EPS, `shares` for the share count) before using the values.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I extract dividends declared per share and total dividends paid?

After converting the filing with `/xbrl-to-json`, read dividends declared on the shareholders'-equity object (`StatementsOfShareholdersEquity.CommonStockDividendsPerShareDeclared`) and total dividends paid on the cash-flow object (`StatementsOfCashFlows.PaymentsOfDividends`). The per-share figure is reported in `usd` per share, while the paid amount is reported in `usd` with a positive or negative sign depending on the issuer's convention; both fields are period arrays that need to be matched on `period.startDate` and `period.endDate` before combining.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I calculate share buybacks for the period from a 10-K?

After converting the 10-K with `/xbrl-to-json`, read the cash outflow for repurchases on the cash-flow object (`StatementsOfCashFlows.PaymentsForRepurchaseOfCommonStock`) for the dollar amount used to buy back stock. The shareholders'-equity object also reports the matching reduction in equity from retiring repurchased shares (`StatementsOfShareholdersEquity.StockRepurchasedAndRetiredDuringPeriodValue`). Each is a period array; pick the entries whose `period.startDate` and `period.endDate` span the fiscal year of interest.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I retrieve total assets, total liabilities, and shareholders' equity in one call?

One call to `/xbrl-to-json` returns the entire balance sheet at once. Total assets are on `BalanceSheets.Assets`, total liabilities on `BalanceSheets.Liabilities`, and shareholders' equity on `BalanceSheets.StockholdersEquity`. Each field is an array of point-in-time entries; pick the entry whose `period.instant` matches the balance-sheet date of interest and that has no `segment` to get the consolidated total.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I get the company's public float and shares outstanding for market-cap calculations?

After converting the filing with `/xbrl-to-json`, read two cover-page fields. The public float is on `CoverPage.EntityPublicFloat` and is reported in `usd` at a specific `period.instant` (typically the last business day of the second fiscal quarter). Shares outstanding are on `CoverPage.EntityCommonStockSharesOutstanding` and are reported in `shares` at a different `period.instant` close to the filing date. Use the `period.instant` on each field to know exactly which date the number is anchored to before combining them for a market-cap estimate.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I check whether a company is a large accelerated filer, smaller reporting company, or emerging growth company?

After converting the filing with `/xbrl-to-json`, read three cover-page fields. The filer category is on `CoverPage.EntityFilerCategory` and takes one of the SEC categories such as `Large Accelerated Filer`. The smaller-reporting-company flag is on `CoverPage.EntitySmallBusiness` and the emerging-growth-company flag on `CoverPage.EntityEmergingGrowthCompany`; both are reported as `true` or `false` strings. The three together identify the issuer's reporting status.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I pull data from foreign issuers that file 20-F or 40-F instead of 10-K?

The `/xbrl-to-json` endpoint converts foreign-issuer XBRL the same way it converts domestic 10-Ks. Supported form types include `20-F`, `20-F/A`, `40-F`, and `40-F/A`, along with their `20FR12B`, `20FR12G`, `40FR12B`, and `40FR12G` registration variants. Provide the filing's URL (`htm-url`), the XBRL instance URL (`xbrl-url`), or the accession number (`accession-no`) and the response carries the same statement objects (`StatementsOfIncome`, `BalanceSheets`, `StatementsOfCashFlows`) plus the `CoverPage` regardless of which form was filed. Be mindful that foreign issuers may report in a non-USD currency, so check `unitRef` before comparing numbers across filers.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001140361-22-009305&token=YOUR_API_KEY
```

### How do I extract financial highlights from mutual fund or ETF prospectus filings?

Investment-company prospectuses such as `485BPOS`, `485APOS`, `N-1A`, and `N-2` are listed as supported XBRL filing types and are converted by the same `/xbrl-to-json` endpoint. Provide the filing's URL (`htm-url`), the XBRL instance URL (`xbrl-url`), or the accession number (`accession-no`); the response includes the cover-page object and any risk-return summary and financial-highlights items the fund tagged in XBRL.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001193125-22-068310&token=YOUR_API_KEY
```

### How do I parse XBRL from S-1 IPO filings to capture pre-IPO financials?

The `/xbrl-to-json` endpoint accepts `S-1`, `S-1/A`, and `S-1MEF` filings in addition to annual and quarterly reports. Provide the registration statement's URL (`htm-url`), XBRL instance URL (`xbrl-url`), or accession number (`accession-no`); the response carries the same financial-statement objects (`StatementsOfIncome`, `BalanceSheets`, `StatementsOfCashFlows`) and `CoverPage` so the pre-IPO figures can be read with the same field paths as a 10-K.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0001193125-20-292381&token=YOUR_API_KEY
```

### How do I capture extra company-specific items that aren't part of standard US GAAP?

In the JSON returned by `/xbrl-to-json`, company-specific extensions appear alongside the US GAAP items inside the same statement object. The converter strips the `us-gaap_` prefix from standard items (so `us-gaap_SalesRevenueGoodsNet` becomes `SalesRevenueGoodsNet`) but leaves custom items under their original company taxonomy name, which is typically prefixed with the issuer's ticker. To capture them, walk every key on each statement object — not just a hard-coded list of GAAP names — and keep keys whose name is unfamiliar; those are the issuer's custom items.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I handle the case where a statement name varies across filers, e.g. "Consolidated Statements of Operations" vs "Consolidated Statements of Loss Income"?

The converter normalizes statement names before returning the JSON, so the consumer does not have to special-case each filer. Variants such as `ConsolidatedStatementsofOperations` and `ConsolidatedStatementsOfLossIncome` are auto-renamed to the canonical root `StatementsOfIncome`. The full set of normalized roots returned by `/xbrl-to-json` includes `StatementsOfIncome`, `StatementsOfComprehensiveIncome`, `BalanceSheets`, `StatementsOfCashFlows`, and `StatementsOfShareholdersEquity` (each with a matching `*Parenthetical` companion), which means the same field paths work across filers.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How do I capture data tagged with multiple simultaneous dimensions, like a fair-value-level-2 commercial paper line on the balance sheet?

On any fact returned by `/xbrl-to-json`, the `segment` key can be either an object or an array of objects. A single-dimension breakdown carries one pair of `segment.dimension` and `segment.value` — for example a fair-value-hierarchy slice where `segment.dimension` is `us-gaap:FairValueByFairValueHierarchyLevelAxis` and `segment.value` is `us-gaap:FairValueInputsLevel2Member`. When a line is tagged on more than one axis at the same time — such as a Level 2 commercial paper position that combines the fair-value-level axis with the financial-instrument axis (`us-gaap:FinancialInstrumentAxis` set to `us-gaap:CommercialPaperMember`) — `segment` is the array form, and every `{dimension, value}` pair in it must match the criteria before the fact is treated as the intended slice. Read every fact as if `segment` could be either shape.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

### How quickly is XBRL JSON available after a filing is published on EDGAR, and how far back does the dataset go for historical backtests?

New filings are converted by `/xbrl-to-json` in under 300 milliseconds after they are published on EDGAR, so the JSON is available essentially in real time for live workflows. Historical coverage starts in 2005 and runs to the present across every XBRL-friendly filing type, and the dataset is survivorship-bias free — filings from filers that are no longer active are retained alongside those from active filers — which makes it suitable for backtests that need to avoid look-ahead and survivorship effects.

```bash
https://api.sec-api.io/xbrl-to-json?accession-no=0000320193-20-000096&token=YOUR_API_KEY
```

## References

- [XBRL Glossary of Terms](https://www.sec.gov/page/osd_xbrlglossary)
- [Inline XBRL](https://www.sec.gov/structureddata/osd-inline-xbrl.html)
- [XBRL Validation and Rendering](https://www.sec.gov/page/osd_edgarvalandrender)
- [Interactive Data Public Test Suite](https://www.sec.gov/structureddata/osdinteractivedatatestsuite)

### Regulations

- [PART 232 - REGULATION S-T - GENERAL RULES AND REGULATIONS FOR ELECTRONIC FILINGS](https://www.ecfr.gov/current/title-17/chapter-II/part-232)
- [§ 229.601 (Item 601) Exhibits.](https://www.ecfr.gov/current/title-17/chapter-II/part-229/subpart-229.600/section-229.601)
- [§ 229.402 (Item 402) Executive compensation.](https://www.ecfr.gov/current/title-17/chapter-II/part-229/subpart-229.400/section-229.402)
- [§ 230.485 Effective date of post-effective amendments filed by certain registered investment companies.](https://www.ecfr.gov/current/title-17/chapter-II/part-230/section-230.485)
- [§ 232.405 Interactive Data File submissions.](https://www.ecfr.gov/current/title-17/chapter-II/part-232/subject-group-ECFR6529c71dfe2cdfb/section-232.405)
- [§ 232.406 Cover Page XBRL Data Tagging.](https://www.ecfr.gov/current/title-17/chapter-II/part-232/subject-group-ECFR6529c71dfe2cdfb/section-232.406)
- [§ 240.17g-7 Disclosure requirements.](https://www.ecfr.gov/current/title-17/chapter-II/part-240/subject-group-ECFR97c9b2f89790a51/section-240.17g-7)
- [§ 240.14a-101 Schedule 14A. Information required in proxy statement.](https://www.ecfr.gov/current/title-17/chapter-II/part-240/section-240.14a-101)
- [§ 240.14c-101 Schedule 14C. Information required in information statement.](https://www.ecfr.gov/current/title-17/chapter-II/part-240/section-240.14c-101)