Locations Reference

Filter jobs by client location using ISO 3166-1 alpha-2 country codes or predefined regions. Both includeLocations and excludeLocations accept an array of location objects.

Country Codes

Common ISO 3166-1 alpha-2 country codes. Any valid two-letter country code is accepted.

Available Regions

Use region values for broader geographic filtering instead of listing individual countries.

Usage Examples

Include specific countries

Only return jobs from clients in the US, UK, Canada, or Australia:

{
  "client": {
    "includeLocations": [
      { "type": "COUNTRY", "value": "US" },
      { "type": "COUNTRY", "value": "GB" },
      { "type": "COUNTRY", "value": "CA" },
      { "type": "COUNTRY", "value": "AU" }
    ]
  }
}

Exclude specific countries

Return jobs from all countries except India, Pakistan, and Bangladesh:

{
  "client": {
    "excludeLocations": [
      { "type": "COUNTRY", "value": "IN" },
      { "type": "COUNTRY", "value": "PK" },
      { "type": "COUNTRY", "value": "BD" }
    ]
  }
}

Use regions

Filter by entire regions instead of listing individual countries:

{
  "client": {
    "includeLocations": [
      { "type": "REGION", "value": "europe" },
      { "type": "REGION", "value": "north_america" }
    ]
  }
}

Combine include and exclude

Include a region but exclude specific countries within it:

{
  "client": {
    "includeLocations": [
      { "type": "REGION", "value": "europe" }
    ],
    "excludeLocations": [
      { "type": "COUNTRY", "value": "RU" }
    ]
  }
}