Alpha AnalystDocs
API Portal

XBRL Search API

Search tagged facts across SEC statement filings—filter by concept, keyword, or accession. Default is five years of period_end unless you narrow it. Requires SEC CIK.

curl -X GET "https://example.com/v2/xbrl?id=AAPL&concepts=us-gaap%3ARevenueFromContractWithCustomerExcludingAssessedTax&limit=8"
{  "id": "AAPL",  "entity": {    "name": "Apple Inc.",    "name_short": "Apple Inc.",    "full_ticker": "AAPL US",    "normalized_ticker": "AAPL",    "backlink_url": "https://alpha-analyst.com/stocks/AAPL",    "category": "EQUITY",    "cik": "0000320193",    "lei": "HWUPKR0MPOU8FGXBT394"  },  "q": null,  "concepts": [    "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax"  ],  "accession": null,  "period_start": "2021-10-09",  "period_end": null,  "consolidated": true,  "count": 8,  "results": [    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 124300000000,      "value_str": "124300000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2024-09-29",      "period_end": "2024-12-29",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2024",      "filing": {        "document_id": "0000320193-25-000008|0",        "filing_id": "0000320193-25-000008",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-25-000008?filename=aapl-20241228.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/aapl-20241228.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/0000320193-25-000008-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 296105000000,      "value_str": "296105000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2023-10-01",      "period_end": "2024-06-30",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2023",      "filing": {        "document_id": "0000320193-24-000081|0",        "filing_id": "0000320193-24-000081",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-24-000081?filename=aapl-20240629.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/aapl-20240629.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/0000320193-24-000081-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 85777000000,      "value_str": "85777000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2024-03-31",      "period_end": "2024-06-30",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2023",      "filing": {        "document_id": "0000320193-24-000081|0",        "filing_id": "0000320193-24-000081",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-24-000081?filename=aapl-20240629.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/aapl-20240629.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/0000320193-24-000081-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 210328000000,      "value_str": "210328000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2023-10-01",      "period_end": "2024-03-31",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2023",      "filing": {        "document_id": "0000320193-24-000069|0",        "filing_id": "0000320193-24-000069",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-24-000069?filename=aapl-20240330.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000069/aapl-20240330.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000069/0000320193-24-000069-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 90753000000,      "value_str": "90753000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2023-12-31",      "period_end": "2024-03-31",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2023",      "filing": {        "document_id": "0000320193-24-000069|0",        "filing_id": "0000320193-24-000069",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-24-000069?filename=aapl-20240330.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000069/aapl-20240330.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000069/0000320193-24-000069-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 119575000000,      "value_str": "119575000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2023-10-01",      "period_end": "2023-12-31",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2024",      "filing": {        "document_id": "0000320193-25-000008|0",        "filing_id": "0000320193-25-000008",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-25-000008?filename=aapl-20241228.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/aapl-20241228.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/0000320193-25-000008-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 383285000000,      "value_str": "383285000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2022-09-25",      "period_end": "2023-10-01",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2023",      "filing": {        "document_id": "0000320193-23-000106|0",        "filing_id": "0000320193-23-000106",        "source": "sec",        "filing_type": "10-K",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-23-000106?filename=aapl-20230930.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/0000320193-23-000106-index.html"      }    },    {      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",      "name": "RevenueFromContractWithCustomerExcludingAssessedTax",      "value": 293787000000,      "value_str": "293787000000.0",      "unit": "USD",      "decimals": -6,      "period_start": "2022-09-25",      "period_end": "2023-07-02",      "period_instant": false,      "dimensions": {},      "taxonomy": "us-gaap",      "taxonomy_version": "2023",      "filing": {        "document_id": "0000320193-24-000081|0",        "filing_id": "0000320193-24-000081",        "source": "sec",        "filing_type": "10-Q",        "backlink_url": "https://alpha-analyst.com/app/filing/0000320193/0000320193-24-000081?filename=aapl-20240629.htm",        "source_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/aapl-20240629.htm",        "source_filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/0000320193-24-000081-index.html"      }    }  ]}
GET
/v2/xbrl

Query Parameters

id*Entity Id

Company or listing id. Same resolve as Entity Reference: ticker (AAPL, AAPL US, AAPL-US), CIK, LEI, EDINET code, CRD, SEC series id, internal id, FIGI, composite FIGI, and share-class FIGI. ISIN and CUSIP match but are never returned. See Ids you can send.

Length1 <= length <= 200
concepts?array<string>

Prefixed tags from XBRL Concepts. Comma-separated on GET. Maximum 20. Required unless q or accession is set.

Items1 <= items <= 20
q?string

Substring used to resolve tags on recent statement filings when concepts is omitted.

Length1 <= length <= 200
accession?string

SEC accession or Document id. Restricts facts to that filing.

Length1 <= length <= 400
period_start?string

Inclusive period_end start (YYYY-MM-DD). Default five years ago unless accession is set.

Formatdate
period_end?string

Inclusive period_end end (YYYY-MM-DD).

Formatdate
period_type?string

duration, instant, or all. Default all. duration is income and cash flow. instant is balance.

Default"all"

Value in

  • "duration"
  • "instant"
  • "all"
consolidated?boolean

true (default) keeps facts with no dimensions. false includes segments.

Defaulttrue
limit?integer

Maximum facts. Default 50. Maximum 200.

Range1 <= value <= 200
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json