---
title: "List country capabilities"
method: GET
path: "/countries"
tags: ["Countries"]
---

# List country capabilities

`GET /countries`

## Request

- Base URL: `https://vatfind.com/v1`
- URL: `https://vatfind.com/v1/countries`
- Auth: none required

## Query parameters

- `query` string

## Response `200`

Country capabilities

- object
  - `object` 'list', required
  - `data` CountryCapability[], required
    - `country_code` string, required
    - `name` string, required
    - `company_search` 'supported' | 'partial' | 'not_verified' | 'not_supported', required: not_verified means the provider has not published a country-level coverage guarantee; searches remain best-effort.
    - `identifier_capabilities` object[], required
      - `identifier_type` 'vat_number' | 'tax_identifier' | 'registration_number', required
      - `format_check` 'supported' | 'partial' | 'not_supported', required
      - `registry_match` 'supported' | 'partial' | 'not_verified' | 'not_supported', required
      - `tax_authority_check` 'supported' | 'partial' | 'not_supported' | 'not_applicable', required
      - `company_legal_status` 'supported' | 'partial' | 'not_verified' | 'not_supported', required
      - `format` object, required
        - `description` string, required
        - `pattern` string
        - `examples` string[], required
    - `updated_at` string, date-time, required
  - `pagination` Pagination, required
    - `limit` integer, required
    - `has_more` boolean, required
    - `next_cursor` string

## Other responses

- `422`: VATFind problem detail
- `500`: VATFind problem detail

---

[API](https://skmtc.dev/vatfind/apis/vatfind-api.md) · [All operations](https://skmtc.dev/vatfind/apis/vatfind-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vatfind/apis/vatfind-api/revisions/5d0b89e6d5cf?raw)