Fiscal.ai - API Reference

Company Key:

A company key combines an exchange and ticker symbol in the format exchange_ticker. For example, for Microsoft Corporation (MSFT) listed on NASDAQ, the company key would be NASDAQ_MSFT.

Use either ticker and exchange OR companyKey.

Companies List

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/companies-list

Get a list of all companies
Lists all companies available in the dataset together with basic descriptors and the types of data available for each company.
GEThttps://api.fiscal.ai/v1/companies-list
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
Responses
An array of companies
[
  {
    "name": "Visa Inc.",
    "ticker": "V",
    "cik": "1403161",
    "exchangeName": "New York Stock Exchange",
    "exchangeSymbol": "NYSE",
    "countryName": "United States",
    "countryCode": "US",
    "sector": "Financials",
    "industryGroup": "Financial Services",
    "industry": "Financial Services",
    "subIndustry": "Transaction & Payment Processing Services",
    "reportingTemplate": "Standard",
    "dataAvailable": [
      "financials"
    ]
  }
]

Try It Out

Company Profile

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/profile

Get profile for a single company
Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system.
GEThttps://api.fiscal.ai/v1/company/profile
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Company profile
{
  "name": "Visa Inc.",
  "ticker": "V",
  "cik": "1403161",
  "exchangeName": "New York Stock Exchange",
  "exchangeSymbol": "NYSE",
  "countryName": "United States",
  "countryCode": "US",
  "sector": "Financials",
  "industryGroup": "Financial Services",
  "industry": "Financial Services",
  "subIndustry": "Transaction & Payment Processing Services",
  "reportingTemplate": "Standard",
  "reportingCurrency": "USD",
  "dataAvailable": [
    "financials"
  ],
  "description": "Visa Inc. is a global payments technology company that facilitates electronic fund transfers among consumers, merchants, financial institutions, and governments in over 200 countries and territories...",
  "shortDescription": "Visa Inc. is a global payments technology company based in Foster City, California, that processes electronic transactions in over 200 countries..."
}

Try It Out

Financials As Reported - Income Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/financials/income-statement/as-reported

Get as-reported financials for a company
Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.
GEThttps://api.fiscal.ai/v1/company/financials/income-statement/as-reported
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
As-reported financial data
{
  "metrics": [
    {
      "asReportedMetricId": "1_IS_65961",
      "metricName": "Products",
      "headers": [
        "Net Sales"
      ],
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "1_IS_65961": {
          "value": 294866000000,
          "unit": "M",
          "currency": "USD",
          "sources": [
            {
              "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
              "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
              "pageNumber": 32
            }
          ]
        }
      }
    }
  ]
}

Try It Out

Financials As Reported - Balance Sheet

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/financials/balance-sheet/as-reported

Get as-reported financials for a company
Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.
GEThttps://api.fiscal.ai/v1/company/financials/balance-sheet/as-reported
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
As-reported financial data
{
  "metrics": [
    {
      "asReportedMetricId": "1_IS_65961",
      "metricName": "Products",
      "headers": [
        "Net Sales"
      ],
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "1_IS_65961": {
          "value": 294866000000,
          "unit": "M",
          "currency": "USD",
          "sources": [
            {
              "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
              "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
              "pageNumber": 32
            }
          ]
        }
      }
    }
  ]
}

Try It Out

Financials As Reported - Cash Flow Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/financials/cash-flow-statement/as-reported

Get as-reported financials for a company
Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.
GEThttps://api.fiscal.ai/v1/company/financials/cash-flow-statement/as-reported
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
As-reported financial data
{
  "metrics": [
    {
      "asReportedMetricId": "1_IS_65961",
      "metricName": "Products",
      "headers": [
        "Net Sales"
      ],
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "1_IS_65961": {
          "value": 294866000000,
          "unit": "M",
          "currency": "USD",
          "sources": [
            {
              "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
              "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
              "pageNumber": 32
            }
          ]
        }
      }
    }
  ]
}

Try It Out

Financials Standardized - Income Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/financials/income-statement/standardized

Get standardized financials for a company
Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.
GEThttps://api.fiscal.ai/v1/company/financials/income-statement/standardized
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
Standardized financial data
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Revenues"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isPointInTime": false,
          "isCurrency": true,
          "isPerShare": false,
          "isKeyMetric": false,
          "operation": "+"
        }
      ]
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "asReportedValues": [
            {
              "asReportedMetricId": "1_IS_65961",
              "metricName": "Products",
              "headers": [
                "Net Sales"
              ],
              "operation": "+",
              "value": 294866000000,
              "unit": "M",
              "currency": "USD",
              "sources": [
                {
                  "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
                  "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
                  "pageNumber": 32
                }
              ]
            }
          ]
        }
      }
    }
  ]
}

Try It Out

Financials Standardized - Balance Sheet

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/financials/balance-sheet/standardized

Get standardized financials for a company
Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.
GEThttps://api.fiscal.ai/v1/company/financials/balance-sheet/standardized
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
Standardized financial data
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Revenues"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isPointInTime": false,
          "isCurrency": true,
          "isPerShare": false,
          "isKeyMetric": false,
          "operation": "+"
        }
      ]
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "asReportedValues": [
            {
              "asReportedMetricId": "1_IS_65961",
              "metricName": "Products",
              "headers": [
                "Net Sales"
              ],
              "operation": "+",
              "value": 294866000000,
              "unit": "M",
              "currency": "USD",
              "sources": [
                {
                  "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
                  "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
                  "pageNumber": 32
                }
              ]
            }
          ]
        }
      }
    }
  ]
}

Try It Out

Financials Standardized - Cash Flow Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/financials/cash-flow-statement/standardized

Get standardized financials for a company
Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.
GEThttps://api.fiscal.ai/v1/company/financials/cash-flow-statement/standardized
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
Standardized financial data
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Revenues"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isPointInTime": false,
          "isCurrency": true,
          "isPerShare": false,
          "isKeyMetric": false,
          "operation": "+"
        }
      ]
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "asReportedValues": [
            {
              "asReportedMetricId": "1_IS_65961",
              "metricName": "Products",
              "headers": [
                "Net Sales"
              ],
              "operation": "+",
              "value": 294866000000,
              "unit": "M",
              "currency": "USD",
              "sources": [
                {
                  "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
                  "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
                  "pageNumber": 32
                }
              ]
            }
          ]
        }
      }
    }
  ]
}

Try It Out

Standardized Metrics List

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/standardized-metrics-list/{templateType}/{statementType}

Get the list of all standardized metrics.
Returns the list of all standardized metrics.
GEThttps://api.fiscal.ai/v1/standardized-metrics-list/{templateType}/{statementType}
Parameters
NameInTypeDescriptionValue
templateType*pathstringReporting template category
statementType*pathstringFinancial statement category
apiKey*querystringAPI Key
Responses
Standardized metrics list
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Income"
      ]
    }
  ]
}

Try It Out

Company Ratios

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/ratios

Get all ratios time series for a company
Calculates and returns all supported financial ratios for the specified company across the selected period types. Where applicable, calculated intermediate metrics are omitted from the response unless diagnostics are requested.
GEThttps://api.fiscal.ai/v1/company/ratios
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
include_diagnosticsquerybooleanInclude diagnostics in the response
ratioIdquerystringReturn only these ratio IDs. Can be provided multiple times or as a comma-separated list.
Responses
All ratios time series
{
  "metrics": [
    {
      "ratioId": "price_to_earnings",
      "metricName": "Price to Earnings",
      "category": "Valuation",
      "isCurrency": false,
      "metricFormat": "ratio",
      "hasDailyData": true
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricValues": {
        "market_data_share_price": 108.73,
        "market_data_total_shares_outstanding": 24388000000,
        "calculated_market_cap": 2651707240000,
        "ratio_price_to_sales": 60.18,
        "ratio_price_to_earnings": 143.07
      }
    }
  ]
}

Try It Out

Daily Ratios

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/ratios/daily/{ratioId}

Get daily ratio time-series for a company
Returns a daily time-series for the specified ratio. The ratio is recomputed for each trading day using the closing share price for that day and the most recently reported fundamental inputs (e.g. EPS, shares outstanding) available as of that date.
GEThttps://api.fiscal.ai/v1/company/ratios/daily/{ratioId}
Parameters
NameInTypeDescriptionValue
ratioId*pathstringID of the ratio (e.g. ratio_price_to_earnings)
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Daily ratio series
[
  {
    "date": "2025-07-10",
    "ratio": 25.34
  }
]

Try It Out

Ratios List

Full List of Ratios:

For a full list of ratios, see our Ratios Resource.

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/ratios-list

Get the list of all ratios.
Returns the list of all ratios.
GEThttps://api.fiscal.ai/v1/ratios-list
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
Responses
Ratios list
[
  {
    "ratioId": "price_to_earnings",
    "metricName": "Price to Earnings",
    "category": "Valuation",
    "isCurrency": false,
    "metricFormat": "ratio",
    "hasDailyData": true
  }
]

Try It Out

Shares Outstanding

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/shares-outstanding

Get the latest shares outstanding for a company
Returns the total number of shares outstanding and detailed share-class breakdown as of the latest available filing for the company.
GEThttps://api.fiscal.ai/v1/company/shares-outstanding
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Shares outstanding
[
  {
    "date": "2025-04-28",
    "totalSharesOutstanding": 908047623,
    "shareClasses": [
      {
        "shareClass": "Class A",
        "isMainShareClass": true,
        "sharesOutstanding": 901263158,
        "conversionRate": 1,
        "sourceDocument": "https://api.fiscal.ai/v1/filing/0001141391-25-000090/pdf?ticker=MA&exchange=NYSE"
      }
    ]
  }
]

Try It Out

Segments and KPIs

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/segments-and-kpis

Get segments and KPIs for a company
Returns segments and KPIs for a company.
GEThttps://api.fiscal.ai/v1/company/segments-and-kpis
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
periodTypequerystringOptional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
Responses
Segments and KPIs
{
  "metrics": [
    {
      "metricId": "total_transaction_volume",
      "metricName": "Total Transaction Volume",
      "metricType": "KPI",
      "metricFormat": "number",
      "isCurrency": true,
      "isImportant": true,
      "isDiscontinued": {
        "example": {
          "Annual": false,
          "Quarterly": false,
          "LTM": false,
          "Semi-Annual": true
        }
      }
    }
  ],
  "segmentGroups": [
    {
      "title": "Revenue",
      "metrics": [
        {
          "name": "Payment Network Revenue",
          "isRollup": false
        }
      ]
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "total_transaction_volume": 9884000000000
      }
    }
  ]
}

Try It Out

Stock Splits

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/stock-splits

Get the stock splits for a company
Provides all historical stock split and stock dividend events for the requested company, including split ratio and relevant dates.
GEThttps://api.fiscal.ai/v1/company/stock-splits
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Stock splits
[
  {
    "announceDate": "2023-01-15",
    "recordDate": "2023-02-01",
    "exDate": "2023-02-05",
    "payDate": "2023-02-10",
    "splitType": "Stock Split",
    "rate": 2
  }
]

Try It Out

Stock Prices

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/stock-prices

Get the stock prices for a company
Returns the daily closing share price series for the specified company. Prices are split-adjusted and expressed in the company reporting currency where applicable.
GEThttps://api.fiscal.ai/v1/company/stock-prices
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Stock prices
[
  {
    "date": "2025-07-10",
    "price": 195.38
  }
]

Try It Out

Company Filings

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/company/filings

Get filings for a company
Retrieves a list of filings for the specified company from the last 20 years, categorized as Annual Reports, Quarterly Reports, Press Releases, or Other documents.
GEThttps://api.fiscal.ai/v1/company/filings
Parameters
NameInTypeDescriptionValue
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
An array of filings
[
  {
    "filing_id": "0000950170-25-100235",
    "document_type": "Annual Report",
    "filing_date": "2025-08-01",
    "report_date": "2025-06-28",
    "pdf_url": "https://api.fiscal.ai/v1/filing/0000950170-25-100235/pdf?ticker=MSFT&exchange=NASDAQ"
  }
]

Try It Out

Filing Image (by page)

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/filing/{filingId}/page/{pageNumber}/image

Get an image of a filing page
Fetches a high-resolution JPEG image of the specified page from the original SEC filing document. Suitable for embedding in client applications for source traceability.
GEThttps://api.fiscal.ai/v1/filing/{filingId}/page/{pageNumber}/image
Parameters
NameInTypeDescriptionValue
filingId*pathstringFiling ID
pageNumber*pathnumberPage number
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Page image
<binary image/jpeg>

Try It Out

Filing PDF

API Key Required
Set your API key to test the endpoints directly from the documentation.

/v1/filing/{filingId}/pdf

Get the full PDF of a filing
Downloads the complete PDF version of the SEC filing referenced by its accession number.
GEThttps://api.fiscal.ai/v1/filing/{filingId}/pdf
Parameters
NameInTypeDescriptionValue
filingId*pathstringFiling ID
apiKey*querystringAPI Key
tickerquerystringCompany ticker (use with exchange, or alone to auto-detect exchange)
exchangequerystringCompany exchange (use with ticker)
companyKeyquerystringCompany key (alternative to ticker & exchange)
Responses
Filing PDF
<binary application/pdf>

Try It Out