> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quantoraresearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data availability

> What exists, how deep it goes, and how to check before you build.

Coverage is uneven. Breadth and depth are different questions, and conflating them is
how teams get surprised in production, so both are published.

## Countries

| Tier                                   | Countries |
| -------------------------------------- | --------- |
| Any data at all                        | 268       |
| Monthly or quarterly data              | 75        |
| Three or more core indicators, current | 50        |
| Complete four indicator panel, current | 22        |

The long tail is annual World Bank series, marked `fallbackOnly`. Real data, useful for
context, and unsuitable for anything time sensitive.

If you need a live panel, build against the 50. If you need breadth for a map or a
ranking, the 268 are there and honestly labelled.

## The rest

| Dataset          | Scale          |
| ---------------- | -------------- |
| US companies     | \~1,900        |
| Indicators       | 258            |
| Sources          | 75             |
| Observations     | \~10.9 million |
| Earliest history | 1871           |

## Check, do not assume

Coverage changes as publishers add and retire series. Three endpoints answer the
question directly rather than by trial and error.

<Steps>
  <Step title="What exists overall">
    <CodeGroup>
      ```bash cURL theme={"dark"}
      curl -H "x-api-key: $QUANTORA_API_KEY" \
        "https://api.financialdatapi.com/coverage"
      ```

      ```python Python theme={"dark"}
      coverage = requests.get(
          "https://api.financialdatapi.com/coverage",
          headers={"x-api-key": KEY},
      ).json()["data"]
      ```
    </CodeGroup>
  </Step>

  <Step title="What exists for one country">
    <CodeGroup>
      ```bash cURL theme={"dark"}
      curl -H "x-api-key: $QUANTORA_API_KEY" \
        "https://api.financialdatapi.com/countries/TUR/available-indicators"
      ```

      ```python Python theme={"dark"}
      indicators = requests.get(
          "https://api.financialdatapi.com/countries/TUR/available-indicators",
          headers={"x-api-key": KEY},
      ).json()["data"]
      ```
    </CodeGroup>
  </Step>

  <Step title="Which countries have one indicator">
    <CodeGroup>
      ```bash cURL theme={"dark"}
      curl -H "x-api-key: $QUANTORA_API_KEY" \
        "https://api.financialdatapi.com/indicators/cpi_inflation_yoy/entities"
      ```

      ```python Python theme={"dark"}
      entities = requests.get(
          "https://api.financialdatapi.com/indicators/cpi_inflation_yoy/entities",
          headers={"x-api-key": KEY},
      ).json()["data"]
      ```
    </CodeGroup>
  </Step>
</Steps>

<Warning>
  An empty `data` array means the series does not exist for that entity. It is not an
  error and does not retry into existence. Check availability first.
</Warning>
