Country values

The location.countryCode filter of People search and Company search, and of their count endpoints, accepts one or more codes from the list below: the ISO 3166-1 alpha-2 codes, plus XK for Kosovo. People search matches the person's country, Company search the country of the headquarters.

Pass a single code or an array of codes. An array is OR-matched.

{
  "location": {
    "countryCode": ["FR", "BE", "CH"]
  }
}

How codes are matched

• Case and surrounding spaces are ignored: fr is read as FR.
• A value that is not on the list, such as a country name or a three-letter code, returns HTTP 422 with error.code INVALID_FILTER_VALUE and up to three suggested codes in details.suggestions. The request costs 0 credits.
• countryCode accepts at most 20 values, like every location sub-field. To cover more countries in one value, use a zone of the area values: "MR:EMEA" covers 131 countries.
• Codes add up with the zones of location.area, while location.region and location.city narrow the result.
• location.country takes a country name in English instead of a code, such as "Germany". A code sent in location.country returns HTTP 422: put codes in countryCode.
• The available-fields endpoints of People search and Company search return the same codes as data, in the allowedValues of the countryCode entry of location.

All country codes (250)