Job Region

Use this API to retrieve the region ID, which can then be used in the Jobs Finder API to filter jobs by region.

GET /v1/jobs/regions

Job Region

cURL

curl --request GET \
  --url https://api.leadmagic.io/v1/jobs/regions \
  --header 'X-API-Key: <api-key>'

200

[
  {
    "id": 1,
    "name": "Africa"
  },
  {
    "id": 2,
    "name": "Asia/Pacific"
  },
  {
    "id": 3,
    "name": "Europe"
  },
  {
    "id": 4,
    "name": "Middle East"
  },
  {
    "id": 5,
    "name": "North America"
  },
  {
    "id": 6,
    "name": "South America"
  }
]

Regions

Get all supported state/province/region codes for filtering job searches.

Free Endpoint — No credits charged. Cache results locally.

Response Fields

Field	Description
id	Region identifier
name	Region/state name
country_id	Parent country code

Combine country_id and region_id for precise geographic targeting (e.g., California only).

Related

Jobs Finder

Use region_id to filter results

Countries

Parent country codes

Authorizations

X-API-Key · string · header · required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Response

200

application/json

Successful response with region list

id · integer · default: 0

name · string

Example:

[
  { "id": 1, "name": "Africa" },
  { "id": 2, "name": "Asia/Pacific" },
  { "id": 3, "name": "Europe" },
  { "id": 4, "name": "Middle East" },
  { "id": 5, "name": "North America" },
  { "id": 6, "name": "South America" }
]