---
updatedAt: 2026-08-11T21:30:36.000Z
agentTools:
  projectIndex: https://docs.dotfile.com/llms.txt
---

# List countries

List all available countries we support with vendor configured in your workspace settings

---

#### See also  
Learn more about [Company data](./company-data-guide)  


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v1/company-data/countries": {
      "get": {
        "operationId": "company-data-countries",
        "summary": "List countries",
        "description": "List all available countries we support with vendor configured in your workspace settings\n\n---\n\n#### See also  \nLearn more about [Company data](./company-data-guide)  \n",
        "parameters": [
          {
            "name": "code",
            "required": false,
            "in": "query",
            "description": "Search country by `code`  \n[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)",
            "schema": {
              "minLength": 2,
              "maxLength": 2,
              "format": "alpha-2",
              "type": "string"
            }
          },
          {
            "name": "vendor",
            "required": false,
            "in": "query",
            "description": "Search country by `vendor`.  \nCould be `pappers`,`kompany`,`creditsafe`,`kyckr`,`companies_house`,`inpi`,`info_camere`,`transparenzregister`,`topograph`,`charity_commission`,`mode_finance` or `none`.",
            "schema": {
              "enum": [
                "pappers",
                "kompany",
                "creditsafe",
                "kyckr",
                "companies_house",
                "inpi",
                "info_camere",
                "transparenzregister",
                "topograph",
                "charity_commission",
                "mode_finance",
                "none"
              ],
              "type": "string"
            }
          },
          {
            "name": "include_none",
            "required": false,
            "in": "query",
            "description": "Include country with `vendor=none` in result.",
            "schema": {
              "default": false,
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns list of countries\n\n**ℹ️ Click to see full payload**",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CountryList"
                }
              }
            }
          },
          "400": {
            "description": "The request is either malformed or contain invalid parameters.\n\n\n  "
          }
        },
        "tags": [
          "Company data"
        ]
      }
    }
  },
  "info": {
    "title": "⚙️ API specifications",
    "description": "Dotfile public API documentation\n\n## Rate limiting\n\nRequests are counted per workspace: every API key of a workspace shares the same quota, across all of Dotfile's servers. Two independent quotas apply per one-minute window:\n\n- **Read** requests (`GET`, `HEAD`): 2,500 requests per minute by default.\n- **Write** requests (every other method): 1,500 requests per minute by default.\n\nEvery response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (Unix timestamp in seconds) and `X-RateLimit-Scope`. Once a quota is exhausted, the API answers `429 Too Many Requests` with a `Retry-After` header giving the number of seconds to wait. Every request counts, including those rejected with a `4xx` status.\n\nContact us if your integration needs a higher quota for your workspace.",
    "version": "v1",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.dotfile.com",
      "description": "Production environment"
    }
  ],
  "components": {
    "securitySchemes": {
      "DotfileAPIKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-DOTFILE-API-KEY",
        "description": "Configure your api key in the Workspace settings"
      }
    },
    "schemas": {
      "Country": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "format": "alpha-2",
            "minLength": 2,
            "maxLength": 2,
            "example": "FR",
            "description": "[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)"
          },
          "name": {
            "type": "string",
            "example": "France"
          },
          "localName": {
            "type": "string",
            "example": "France"
          },
          "emoji": {
            "type": "string",
            "example": "🇫🇷"
          },
          "emojiCode": {
            "type": "string",
            "example": "1F1EB 1F1F7"
          },
          "vendor": {
            "type": "string",
            "enum": [
              "pappers",
              "kompany",
              "creditsafe",
              "kyckr",
              "companies_house",
              "inpi",
              "info_camere",
              "transparenzregister",
              "topograph",
              "charity_commission",
              "mode_finance",
              "none"
            ],
            "example": "pappers"
          }
        },
        "required": [
          "code",
          "name",
          "localName",
          "emoji",
          "emojiCode",
          "vendor"
        ]
      },
      "CountryList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Country"
            }
          }
        },
        "required": [
          "data"
        ]
      }
    }
  },
  "security": [
    {
      "DotfileAPIKey": []
    }
  ],
  "x-uploaded-at": "2026-10-29T16:29:52.073Z",
  "x-commit-sha": "b389d115e1cb6a813feec644c385eb337a90f572"
}
```