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

# Get Global Tax Exposure

> Retrieve a hierarchical breakdown of your tax exposure across countries, states, and counties.

Use this endpoint to fetch a real-time summary of your tax exposure across all supported countries. The response includes a nested structure showing totals at the country level, with optional breakdowns for states and counties where applicable.

***

### Response Fields

Each item in the response may include:

* `country` – ISO 3166-1 alpha-2 country code (e.g., `US`, `IN`, `FR`)
* `country_name` – Full name of the country
* `exposure_amount` – Total exposure in minor units (e.g., cents, paise)
* `currency` – ISO 4217 currency code (e.g., `USD`, `EUR`, `INR`)
* `jurisdictions[]` *(optional)* – State or region-level breakdowns:
  * `state` – State or region code
  * `state_name` – Full name of the state or region
  * `exposure_amount` – Exposure amount at the state level
  * `counties[]` *(optional)* – County-level exposure within the state:
    * `county` – Name of the county
    * `exposure_amount` – County-level exposure

***

### Notes

* All monetary fields (`exposure_amount`) are returned as integers, multiplied by 100 (e.g., `190000` = 1,900.00).
* Jurisdiction and county fields only appear if exposure exists at those levels.
* Ideal for generating compliance dashboards, audit reports, or jurisdiction-specific financial summaries.


## OpenAPI

````yaml GET /v1/exposure/countries
openapi: 3.0.1
info:
  title: Antei API Reference
  description: >-
    Programmatic access to Antei’s platform. Use this API to manage core objects
    and retrieve taxation insights.
  version: 1.0.0
  license:
    name: MIT
  contact:
    name: Antei Developer Support
    email: support@antei.com
    url: https://antei.com
servers:
  - url: https://api.antei.com
security:
  - bearerAuth: []
paths:
  /v1/exposure/countries:
    get:
      tags:
        - Exposure
      summary: Get Country-wise Exposure Overview
      description: >-
        Retrieve exposure data across countries, jurisdictions, and counties for
        your organization using your API key.
      responses:
        '200':
          description: Exposure summary across supported countries and jurisdictions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExposureOverviewResponse'
        '401':
          description: Unauthorized – Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    ExposureOverviewResponse:
      type: object
      properties:
        exposure:
          type: array
          description: List of countries with exposure data
          items:
            $ref: '#/components/schemas/CountryExposure'
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        status:
          type: integer
    CountryExposure:
      type: object
      properties:
        country_code:
          type: string
          description: ISO 3166 Alpha-2 country code (e.g., 'US')
        country_name:
          type: string
          description: Full country name (e.g., 'United States')
        exposure_amount:
          type: integer
          description: Total exposure in minor units (e.g., cents or basis points)
        jurisdictions:
          type: array
          description: Optional list of jurisdiction-level exposures
          items:
            $ref: '#/components/schemas/JurisdictionExposure'
    JurisdictionExposure:
      type: object
      properties:
        jurisdiction_code:
          type: string
          description: State or region code (e.g., 'CA')
        jurisdiction_name:
          type: string
          description: Full name of the jurisdiction
        exposure_amount:
          type: integer
          description: Exposure amount at the jurisdiction level
        counties:
          type: array
          description: Optional breakdown by counties/districts
          items:
            $ref: '#/components/schemas/CountyExposure'
    CountyExposure:
      type: object
      properties:
        county_name:
          type: string
          description: Name of the county or district
        exposure_amount:
          type: integer
          description: Exposure at the county level
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````