🔗 REST APIXBRL Converter

Convert XBRL data to JSON format

Converts XBRL data to JSON format using one of three possible input methods.

Input Methods

  1. HTML URL (htm-url)

  2. XBRL URL (xbrl-url)

  3. Accession Number (accession-no)

    • The SEC filing accession number
    • Example: 0001564590-21-004599

Only one of the three parameters should be provided. If multiple parameters are provided, the priority order is:

  1. htm-url
  2. xbrl-url
  3. accession-no

Supported Filing Types

  • Annual Reports (10-K)
  • Quarterly Reports (10-Q)
  • Current Reports (8-K)
  • Registration Statements (S-1, S-3)
  • Foreign Private Issuer Reports (20-F, 40-F)

Response Format

The API returns a JSON object containing:

  • Financial statements (Income Statement, Balance Sheet, Cash Flow Statement)
  • Accounting policies and footnotes
  • Company information
  • Filing metadata

Example Response

{
  "StatementsOfIncome": {
    "RevenueFromContractWithCustomerExcludingAssessedTax": [
      {
        "decimals": "-6",
        "unitRef": "U_USD",
        "period": {
          "startDate": "2023-07-01",
          "endDate": "2024-06-30"
        },
        "value": "245122000000"
      }
    ]
  }
}
GET
/v1/xbrl-converter

Authorization

headerAuthorization<token>

API Key is required to access the endpoints

Query Parameters

htm-url?string

URL of the filing ending with .htm or .html

xbrl-url?string

URL of the XBRL file ending with .xml

accession-no?string

SEC filing accession number

Response Body

Successful conversion

application/json
  1. response
[key: string]?unknown
curl -X GET 'https://api.sec.finfeedapi.com/v1/xbrl-converter'
{  "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"      }    ],    "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"      }    ],    "SecurityExchangeName": [      {        "period": {          "startDate": "2019-09-29",          "endDate": "2020-09-26"        },        "segment": {          "dimension": "us-gaap:StatementClassOfStockAxis",          "value": "us-gaap:CommonStockMember"        },        "value": "NASDAQ"      }    ],    "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"      }    ],    "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"    }  },  "BalanceSheets": {},  "BalanceSheetsParenthetical": {},  "StatementsOfShareholdersEquity": {},  "StatementsOfCashFlows": {},  "SummaryofSignificantAccountingPolicies": {},  "SummaryofSignificantAccountingPoliciesPolicies": {},  "SummaryofSignificantAccountingPoliciesTables": {},  "SummaryofSignificantAccountingPoliciesAdditionalInformationDetails": {},  "SummaryofSignificantAccountingPoliciesComputationofBasicandDilutedEarningsPerShareDetails": {},  "RevenueRecognition": {},  "RevenueRecognitionTables": {},  "RevenueRecognitionAdditionalInformationDetails": {},  "RevenueRecognitionDeferredRevenueExpectedTimingofRealizationDetails": {},  "RevenueRecognitionNetSalesDisaggregatedbySignificantProductsandServicesDetails": {},  "FinancialInstruments": {},  "FinancialInstrumentsTables": {},  "FinancialInstrumentsCashCashEquivalentsandMarketableSecuritiesDetails": {}}

Full-text search of SEC filing documents GET

Previous Page

Introduction

WebSocket endpoint provides real-time SEC filings streaming. After establishing a WebSocket connection, the server first delivers a historical backlog and then streams new filings in real-time.