Execute an Offline Job

API Reference for Executing Offline Jobs

fsq_job_id

Type: string
Required: Yes
The ID of the offline job to execute.

country_codes

Type: string
The list of country codes to include in the job. Valid country codes can be found here. This is only required for place_match jobs.

X-Places-Api-Version

Type: string
Enum: required
Defaults to 2025-06-17
The version of the API to use.
Allowed: 2025-06-17

Response

200 success

Type: object

job_id: string
status: string

Error Responses

400: Bad request
404: job not found
500: Internal server error

Example Request

curl --request POST \
     --url https://places-api.foursquare.com/offline-jobs/fsq_job_id/execute \
     --header 'X-Places-Api-Version: 2025-06-17' \
     --header 'accept: application/json'

Example Response

{
  "job_id": "string",
  "status": "string"
}