Fiscal.ai

https://docs.fiscal.ai/docs/
Admin
Fiscal.ai is an institutional-quality financial data API platform providing clean fundamentals,...
Tokens:42,303
Snippets:247
Trust Score:8
Update:5 months ago
Show doc for...
Tokens:
Raw
### Companies List Response Example

Source: https://docs.fiscal.ai/docs/api-reference

This is an example of the JSON response when requesting a list of companies. It includes pagination details and a sample company object with its basic descriptors.

```json
{
  "pagination": {
    "page": 1,
    "pageSize": 1000,
    "totalCount": 11069,
    "totalPages": 12,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "data": [
    {
      "name": "Constellation Software Inc.",
      "ticker": "CSU",
      "exchangeName": "Toronto Stock Exchange",
      "micCode": "XTSE",
      "exchangeSymbol": "TSX",
      "countryName": "Canada",
      "countryCode": "CA",
      "tradingCurrency": "CAD",
      "reportingCurrency": "USD",
      "sector": "Information Technology",
      "industryGroup": "Software & Services",
      "industry": "Software",
      "subIndustry": "Application Software",
      "reportingTemplate": "Standard",
      "availableDatasets": "financials",
      "cik": "string",
      "cusip": "21037X100",
      "isin": "CA21037X1006"
    }
  ]
}
```

--------------------------------

### Get List of All Ratios

Source: https://docs.fiscal.ai/docs/api-reference

Fetch a comprehensive list of all available financial ratios. An API key is required for this endpoint.

```bash
$ curl "https://api.fiscal.ai/v1/ratios-list"
```

--------------------------------

### Get List of All Ratios

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves a comprehensive list of all available financial ratios supported by the API.

```APIDOC
## GET /v1/ratios-list

### Description
Get the list of all ratios.

### Method
GET

### Endpoint
`/v1/ratios-list`

### Parameters
#### Query Parameters
- **apiKey** (string) - Optional - API Key (alternatively send via X-Api-Key header)

### Request Example
```bash
curl "https://api.fiscal.ai/v1/ratios-list"
```

### Response
#### Success Response (200)
- **ratioId** (string) - Unique identifier for the ratio.
- **metricName** (string) - Human-readable name of the ratio.
- **category** (string) - Category the ratio belongs to (e.g., Valuation).
- **isCurrency** (boolean) - Indicates if the ratio is currency-related.
- **metricFormat** (string) - The format of the metric (e.g., ratio).
- **hasDailyData** (boolean) - Indicates if daily data is available for this ratio.
- **formulaHuman** (string) - Human-readable formula for calculating the ratio.

#### Response Example
```json
[
  {
    "ratioId": "price_to_earnings",
    "metricName": "Price to Earnings",
    "category": "Valuation",
    "isCurrency": false,
    "metricFormat": "ratio",
    "hasDailyData": true,
    "formulaHuman": "Market Price per Share / Earnings per Share"
  }
]
```
```

--------------------------------

### Quick Connection Test Prompt

Source: https://docs.fiscal.ai/docs/guides/mcp-integration

Ask your AI assistant this prompt after setup to test the connection. It requests the company profile for NASDAQ_MSFT, which is accessible on the free plan.

```text
Get the company profile for NASDAQ_MSFT

```

--------------------------------

### Webhook Payload Example

Source: https://docs.fiscal.ai/docs/guides/webhooks

This is an example of the JSON payload structure sent to your webhook endpoint when financial data is updated. It includes event details, company identifiers, and timestamps.

```json
{
  "event_type": "financial_data_updated",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "company_key": "NASDAQ_AAPL",
  "statement_type": "income_statement",
  "file_type": "financial_data_as_reported",
  "metadata": {
    "source": "fiscal",
    "version": "1.0"
  }
}

```

--------------------------------

### Get List of Companies

Source: https://docs.fiscal.ai/docs/api-reference

Use this endpoint to retrieve a list of companies. API Key is required and can be sent via header.

```bash
$ curl "https://api.fiscal.ai/v1/companies-list"
```

--------------------------------

### Standardized Income Statement Response Example

Source: https://docs.fiscal.ai/docs/api-reference

Example of a successful response for standardized income statement data. It details the reporting template, metrics, and financial data for a specific period, including original and converted currency values.

```json
{
  "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,
          "unit": "M",
          "currency": "USD",
          "originalValue": 334218000000,
          "originalCurrency": "EUR",
          "appliedExchangeRate": 1.17,
          "asReportedValues": [
            {
              "asReportedMetricId": "1_IS_65961",
              "metricName": "Products",
              "headers": [
                "Net Sales"
              ],
              "operation": "+",
              "value": 294866000000,
              "unit": "M",
              "currency": "USD",
              "originalValue": 251340000000,
              "originalCurrency": "EUR",
              "appliedExchangeRate": 1.17,
              "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
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
```

--------------------------------

### Missing Parameters Error (400) Example

Source: https://docs.fiscal.ai/docs/guides/rate-limits

This JSON response indicates missing required parameters for the request, returning a 400 Bad Request status code.

```json
{
  "error": "Missing required parameters: either Company Key, CUSIP, ISIN, FIGI, or Ticker + Exchange"
}
```

--------------------------------

### Get Daily Ratio for a Company

Source: https://docs.fiscal.ai/docs/api-reference

Retrieve daily ratio data for a specific company using its company key or FIGI. Ensure the ratio ID is valid.

```bash
$ curl "https://api.fiscal.ai/v1/company/ratios/daily/ratio_price_to_earnings?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84&currency=CAD"
```

--------------------------------

### Get Company Profile with API Key

Source: https://docs.fiscal.ai/docs/guides/getting-started

Use this cURL command to fetch a company's profile. Remember to replace `YOUR_API_KEY` with your actual API key.

```curl
curl -X GET "https://api.fiscal.ai/v1/company/profile?companyKey=NASDAQ_MSFT&apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

--------------------------------

### Feature Access Denied Error (403) Example

Source: https://docs.fiscal.ai/docs/guides/rate-limits

This JSON response indicates that the user does not have access to the requested feature, returning a 403 Forbidden status code.

```json
{
  "error": "You do not have access to this feature"
}
```

--------------------------------

### Company Not Found Error (404) Example

Source: https://docs.fiscal.ai/docs/guides/rate-limits

This JSON response is returned when the specified company cannot be found, resulting in a 404 Not Found status code.

```json
{
  "error": "Company not found"
}
```

--------------------------------

### Authentication Error (401) Example

Source: https://docs.fiscal.ai/docs/guides/rate-limits

This JSON response is returned when an invalid API key is provided, resulting in a 401 Unauthorized status code.

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Company Profile Response Example

Source: https://docs.fiscal.ai/docs/api-reference

This JSON object represents the detailed profile of a company, including its name, ticker, exchange information, sector, industry, and available datasets.

```json
{
  "name": "Constellation Software Inc.",
  "ticker": "CSU",
  "exchangeName": "Toronto Stock Exchange",
  "micCode": "XTSE",
  "exchangeSymbol": "TSX",
  "countryName": "Canada",
  "countryCode": "CA",
  "tradingCurrency": "CAD",
  "reportingCurrency": "USD",
  "sector": "Information Technology",
  "industryGroup": "Software & Services",
  "industry": "Software",
  "subIndustry": "Application Software",
  "reportingTemplate": "Standard",
  "availableDatasets": "financials",
  "cik": "string",
  "cusip": "21037X100",
  "isin": "CA21037X1006",
  "description": "string",
  "shortDescription": "string"
}
```

--------------------------------

### Get Stock Splits for a Company

Source: https://docs.fiscal.ai/docs/api-reference

Retrieve historical stock split and dividend events for a company. Use parameters like `companyKey` or `figi` to identify the company.

```bash
$ curl "https://api.fiscal.ai/v1/company/stock-splits?companyKey=NASDAQ_NVDA&figi=BBG000BVPV84"
```

--------------------------------

### Fetch Balance Sheet Data

Source: https://docs.fiscal.ai/docs/api-reference

Example of fetching as-reported balance sheet data for a company using companyKey, FIGI, periodType, and currency parameters. The response includes detailed financial metrics and source information.

```bash
$ curl "https://api.fiscal.ai/v1/company/financials/balance-sheet/as-reported?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84&periodType=annual%2Cquarterly&currency=CAD"
```

```json
{
  "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": 264258909200,
          "unit": "M",
          "currency": "EUR",
          "originalValue": 294866000000,
          "originalCurrency": "USD",
          "appliedExchangeRate": 0.8962,
          "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,
              "originalSourceUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
            }
          ]
        }
      }
    }
  ]
}
```

--------------------------------

### Get Adjusted Metrics

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves the latest adjusted financial metrics for a company.

```APIDOC
## GET /v1/company/adjusted-metrics

### Description
Get the latest adjusted metrics for a company.

### Method
GET

### Endpoint
`/v1/company/adjusted-metrics`

### Parameters
#### Query Parameters
- **apiKey** (string) - Optional - API Key (alternatively send via X-Api-Key header)
- **ticker** (string) - Optional - Company ticker, use with mic or alone for US tickers
- **micCode** (string) - Optional - Company MIC, use with ticker
- **exchange** (string) - Optional - Company exchange code, use with ticker
- **companyKey** (string) - Optional - Company key (alternative to ticker/micCode/exchange)
- **cusip** (string) - Optional - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- **isin** (string) - Optional - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- **figi** (string) - Optional - FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- **cik** (string) - Optional - Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

### Response
#### Success Response (200)
Returns the adjusted metrics for a company. (Specific fields not detailed in source)
```

--------------------------------

### Free Trial Company Access Denied Error (403) Example

Source: https://docs.fiscal.ai/docs/guides/rate-limits

This JSON response is returned when attempting to access a company not available on the free trial, resulting in a 403 Forbidden status code.

```json
{
  "error": "This company is not available for the free trial."
}
```

--------------------------------

### Get Stock Prices

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves the daily stock price series for a specified company.

```APIDOC
## GET /v2/company/stock-prices

### Description
Get the stock prices for a company. Returns the daily stock price series for the specified company, including open price, close price, and volume. Prices are split-adjusted and expressed in the company reporting currency where applicable. Secondary listings return their own price series; if unavailable, the primary listing's prices are returned as a fallback.

### Method
GET

### Endpoint
/v2/company/stock-prices

### Parameters
#### Query Parameters
- **apiKey** (string) - API Key (alternatively send via X-Api-Key header)
- **ticker** (string) - Company ticker, use with mic or alone for US tickers
- **micCode** (string) - Company MIC, use with ticker
- **exchange** (string) - Company exchange code, use with ticker
- **companyKey** (string) - Company key (alternative to ticker/micCode/exchange)
- **cusip** (string) - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- **isin** (string) - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- **figi** (string) - FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- **cik** (string) - Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.
- **startDate** (string) - The start date for the price series.
- **endDate** (string) - The end date for the price series.
- **latest** (boolean) - If true, returns only the most recent stock price.

### Request Example
```bash
curl "https://api.fiscal.ai/v2/company/stock-prices?companyKey=NASDAQ_MSFT&figi=BBG000BPH459&startDate=2024-01-01&endDate=2024-12-31"
```

### Response
#### Success Response (200)
- **date** (string) - The date of the stock price data.
- **open_price** (number) - The opening price of the stock on the given date.
- **close_price** (number) - The closing price of the stock on the given date.
- **volume** (number) - The trading volume for the stock on the given date.

#### Response Example
```json
[
  {
    "date": "2025-07-10",
    "open_price": 193.12,
    "close_price": 195.38,
    "volume": 5432100
  }
]
```
```

--------------------------------

### Fetch Stock Prices with Company Key and FIGI

Source: https://docs.fiscal.ai/docs/api-reference

Use this endpoint to retrieve stock prices for a specific company by providing its company key and FIGI. Ensure you have the correct API key for authentication.

```bash
$ curl "https://api.fiscal.ai/v1/company/stock-prices?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84"
```

```json
[
  {
    "date": "2025-07-10",
    "price": 195.38
  }
]
```

--------------------------------

### Get Company Filings (v2)

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves a list of filings for a specified company from the last 20 years.

```APIDOC
## GET /v2/company/filings

### Description
Get filings for a company. Retrieves a list of filings for the specified company from the last 20 years. Currently supports: - Annual Report - Interim Report - Earnings Press Release - Current Report - Initial Registration Statement The fiscal year, quarter, and report date are only available if there was financial data extracted from the filing.

### Method
GET

### Endpoint
/v2/company/filings

### Parameters
#### Query Parameters
- **apiKey** (string) - API Key (alternatively send via X-Api-Key header)
- **ticker** (string) - Company ticker, use with mic or alone for US tickers
- **micCode** (string) - Company MIC, use with ticker
- **exchange** (string) - Company exchange code, use with ticker
- **companyKey** (string) - Company key (alternative to ticker/micCode/exchange)
- **cusip** (string) - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- **isin** (string) - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- **figi** (string) - FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- **cik** (string) - Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

### Request Example
```bash
curl "https://api.fiscal.ai/v2/company/filings?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84"
```

### Response
#### Success Response (200)
- **filingId** (string) - Unique identifier for the filing.
- **documentType** (string) - The type of the filing (e.g., "Earnings Press Release").
- **filingDate** (string) - The date the filing was submitted.
- **reportDate** (string) - The date the report covers.
- **fiscalYear** (integer) - The fiscal year the report pertains to.
- **fiscalQuarter** (integer) - The fiscal quarter the report pertains to.
- **pdfUrl** (string) - URL to the PDF version of the filing.
- **sourceUrl** (string) - URL to the original source of the filing.

#### Response Example
```json
[
  {
    "filingId": "0000002208-25-4901693",
    "documentType": "Earnings Press Release",
    "filingDate": "2025-02-26",
    "reportDate": "2024-12-31",
    "fiscalYear": 2024,
    "fiscalQuarter": 4,
    "pdfUrl": "https://api.fiscal.ai/v1/filing/0000002208-25-4901693/pdf?companyKey=TSX_TOI",
    "sourceUrl": "https://www.sedarplus.ca/csa-party/records/document.html?id=34628a35c29576e2221ea35daaba7999b10cd4c4604b19f72b3c4620508ca224"
  }
]
```
```

--------------------------------

### Get Daily Ratio Time Series for a Company

Source: https://docs.fiscal.ai/docs/api-reference

Fetches a daily time-series for a specified financial ratio for a company. The ratio is recalculated daily using the closing share price and the latest available fundamental data.

```bash
GET`/v1/company/ratios/daily/ratio_price_to_earnings`
```

--------------------------------

### Get Stock Splits

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves all historical stock split and stock dividend events for a specified company.

```APIDOC
## GET /v1/company/stock-splits

### Description
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.

### Method
GET

### Endpoint
/v1/company/stock-splits

### Parameters
#### Query Parameters
- **apiKey** (string) - API Key (alternatively send via X-Api-Key header)
- **ticker** (string) - Company ticker, use with mic or alone for US tickers
- **micCode** (string) - Company MIC, use with ticker
- **exchange** (string) - Company exchange code, use with ticker
- **companyKey** (string) - Company key (alternative to ticker/micCode/exchange)
- **cusip** (string) - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- **isin** (string) - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- **figi** (string) - FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- **cik** (string) - Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

### Request Example
```bash
curl "https://api.fiscal.ai/v1/company/stock-splits?companyKey=NASDAQ_NVDA&figi=BBG000BVPV84"
```

### Response
#### Success Response (200)
- **announceDate** (string) - The date the stock split was announced.
- **recordDate** (string) - The date on which shareholders must be registered to receive the stock split.
- **exDate** (string) - The date on which the stock begins trading on a split-adjusted basis.
- **payDate** (string) - The date on which the stock split is paid out.
- **splitType** (string) - The type of split (e.g., "Stock Split").
- **rate** (number) - The ratio of the stock split (e.g., 2 for a 2-for-1 split).

#### Response Example
```json
[
  {
    "announceDate": "2023-01-15",
    "recordDate": "2023-02-01",
    "exDate": "2023-02-05",
    "payDate": "2023-02-10",
    "splitType": "Stock Split",
    "rate": 2
  }
]
```
```

--------------------------------

### List Standardized Metrics

Source: https://docs.fiscal.ai/docs/api-reference

Use this endpoint to retrieve a list of all available standardized financial metrics. The API key can be sent in the request or as an 'X-Api-Key' header.

```bash
$ curl "https://api.fiscal.ai/v1/standardized-metrics-list"
```

--------------------------------

### Add Fiscal.ai MCP Server via CLI

Source: https://docs.fiscal.ai/docs/guides/mcp-integration

Use this command to add the Fiscal.ai MCP server to your Claude client via the command-line interface. This enables access to financial data tools.

```bash
claude mcp add --transport sse fiscal https://api.fiscal.ai/mcp/sse

```

--------------------------------

### Get Daily Ratio Series

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves the daily time series for a specific financial ratio for a given company.

```APIDOC
## GET /v1/company/ratios/daily/{ratioId}

### Description
Retrieves the daily time series for a specific financial ratio for a given company.

### Method
GET

### Endpoint
`/v1/company/ratios/daily/{ratioId}`

### Parameters
#### Path Parameters
- **ratioId** (string) - Required - ID of the ratio (e.g. ratio_price_to_earnings)

#### Query Parameters
- **apiKey** (string) - Optional - API Key (alternatively send via X-Api-Key header)
- **ticker** (string) - Optional - Company ticker, use with mic or alone for US tickers
- **micCode** (string) - Optional - Company MIC, use with ticker
- **exchange** (string) - Optional - Company exchange code, use with ticker
- **companyKey** (string) - Optional - Company key (alternative to ticker/micCode/exchange)
- **cusip** (string) - Optional - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- **isin** (string) - Optional - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- **figi** (string) - Optional - FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- **cik** (string) - Optional - Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.
- **currency** (string) - Optional - ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

### Request Example
```bash
curl "https://api.fiscal.ai/v1/company/ratios/daily/ratio_price_to_earnings?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84&currency=CAD"
```

### Response
#### Success Response (200)
- **date** (string) - The date of the ratio data.
- **ratio** (number) - The value of the ratio on the given date.

#### Response Example
```json
[
  {
    "date": "2025-07-10",
    "ratio": 25.34
  }
]
```
```

--------------------------------

### Get Adjusted Metrics for a Company

Source: https://docs.fiscal.ai/docs/api-reference

Retrieve the latest adjusted metrics for a specified company. This endpoint requires an API key.

--------------------------------

### Companies List

Source: https://docs.fiscal.ai/docs/api-reference

Get a list of all companies available in the dataset together with basic descriptors and the types of data available for each company.

```APIDOC
## GET /v2/companies-list

### Description
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.

### Method
GET

### Endpoint
/v2/companies-list

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - API Key (alternatively send via X-Api-Key header)
- **pageNumber** (number) - Optional - Page number (1-indexed)
- **pageSize** (number) - Optional - Number of items per page, max 1000

### Request Example
```bash
curl "https://api.fiscal.ai/v2/companies-list?pageNumber=1&pageSize=1000"
```

### Response
#### Success Response (200)
An array of companies

#### Response Example
```json
{
  "pagination": {
    "page": 1,
    "pageSize": 1000,
    "totalCount": 11069,
    "totalPages": 12,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "data": [
    {
      "name": "Constellation Software Inc.",
      "ticker": "CSU",
      "exchangeName": "Toronto Stock Exchange",
      "micCode": "XTSE",
      "exchangeSymbol": "TSX",
      "countryName": "Canada",
      "countryCode": "CA",
      "tradingCurrency": "CAD",
      "reportingCurrency": "USD",
      "sector": "Information Technology",
      "industryGroup": "Software & Services",
      "industry": "Software",
      "subIndustry": "Application Software",
      "reportingTemplate": "Standard",
      "availableDatasets": "financials",
      "cik": "string",
      "cusip": "21037X100",
      "isin": "CA21037X1006"
    }
  ]
}
```
```

--------------------------------

### Get Standardized Income Statement

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves standardized financial statements for a company, allowing for direct comparison across different companies.

```APIDOC
## GET /v1/company/financials/income-statement/standardized

### Description
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.

### Method
GET

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

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - API Key (alternatively send via X-Api-Key header)

### Response
#### Success Response (200)
[Details of the standardized income statement response would be listed here if provided in the source.]

#### Response Example
[An example of the standardized income statement response would be listed here if provided in the source.]
```

--------------------------------

### Get Shares Outstanding

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves the latest shares outstanding information for a company, including total shares and breakdown by share class.

```APIDOC
## GET /v1/company/shares-outstanding

### Description
Get the latest shares outstanding for a company.

### Method
GET

### Endpoint
`/v1/company/shares-outstanding`

### Parameters
#### Query Parameters
- **apiKey** (string) - Optional - API Key (alternatively send via X-Api-Key header)
- **ticker** (string) - Optional - Company ticker, use with mic or alone for US tickers
- **micCode** (string) - Optional - Company MIC, use with ticker
- **exchange** (string) - Optional - Company exchange code, use with ticker
- **companyKey** (string) - Optional - Company key (alternative to ticker/micCode/exchange)
- **cusip** (string) - Optional - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- **isin** (string) - Optional - Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- **figi** (string) - Optional - FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- **cik** (string) - Optional - Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

### Request Example
```bash
curl "https://api.fiscal.ai/v1/company/shares-outstanding?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84"
```

### Response
#### Success Response (200)
- **date** (string) - The date of the shares outstanding data.
- **totalSharesOutstanding** (integer) - The total number of shares outstanding.
- **shareClasses** (array) - An array of objects, each representing a share class.
  - **shareClass** (string) - The name of the share class.
  - **isMainShareClass** (boolean) - Indicates if this is the main share class.
  - **sharesOutstanding** (integer) - The number of shares outstanding for this class.
  - **conversionRate** (number) - The conversion rate for this share class.
  - **sourceDocument** (string) - URL to the source document for this data.

#### Response Example
```json
[
  {
    "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"
      }
    ]
  }
]
```
```

--------------------------------

### Get All Standardized Metrics

Source: https://docs.fiscal.ai/docs/api-reference

Retrieves a list of all unique standardized metrics across all reporting templates. This endpoint requires an API key.

```APIDOC
## GET /v1/standardized-metrics-list

### Description
Retrieves a list of all unique standardized metrics across all reporting templates. This endpoint requires an API key.

### Method
GET

### Endpoint
/v1/standardized-metrics-list

### Parameters
#### Query Parameters
- **apiKey** (string) - API Key (alternatively send via X-Api-Key header)

### Response
#### Success Response (200)
Returns every unique standardized metric, with an array indicating which reporting templates each metric belongs to.

#### Response Example
```json
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Income"
      ]
    }
  ]
}
```
```

--------------------------------

### Configure Direct SSE MCP Server

Source: https://docs.fiscal.ai/docs/guides/mcp-integration

JSON configuration for MCP clients that support direct SSE connections with OAuth. This specifies the Fiscal.ai server URL.

```json
{
  "mcpServers": {
    "fiscal": {
      "url": "https://api.fiscal.ai/mcp/sse"
    }
  }
}

```

--------------------------------

### Get Company Filings

Source: https://docs.fiscal.ai/docs/api-reference

Retrieve a list of filings for a specified company. This endpoint is deprecated; use v2 instead. API Key is required.

```bash
$ curl "https://api.fiscal.ai/v1/company/filings?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84"
```

--------------------------------

### Get Company Filings

Source: https://docs.fiscal.ai/docs/api-reference

Retrieve a list of company filings from the last 20 years, including annual reports, interim reports, and earnings releases. Filter by `companyKey` or other identifiers.

```bash
$ curl "https://api.fiscal.ai/v2/company/filings?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84"
```

--------------------------------

### Fetch As-Reported Income Statement Data

Source: https://docs.fiscal.ai/docs/api-reference

Use this endpoint to retrieve raw, as-reported financial data for a company's income statement. Parameters like companyKey, figi, periodType, and currency can be specified to filter the results. The API returns detailed metrics and values, including source document links.

```bash
$ curl "https://api.fiscal.ai/v1/company/financials/income-statement/as-reported?companyKey=NASDAQ_MSFT&figi=BBG000BVPV84&periodType=annual%2Cquarterly&currency=CAD"
```
Tokens:
Raw