job_ids

string

An optional comma-separated list of IDs of the Places API offline jobs to get statuses for. These IDs are returned when Places API offline jobs are initialized. If not provided, statuses for all of your previously submitted jobs will be returned.

X-Places-Api-Version

string

enum

required

Defaults to 2025-06-17

The version of the API to use.

2025-06-17

Allowed:

2025-06-17

Response Codes

200 success

object

job_statuses

array of objects

• job_statuses

• object

  • job_id
    • string
  • status
    • string
  • start_time
    • object
  • end_time
    • object
  • errors
    • array of strings

400 bad request

401 unauthorized

Example Request

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

Example Response

{
  "job_statuses": [
    {
      "job_id": "string",
      "status": "string",
      "start_time": {},
      "end_time": {},
      "errors": [
        "string"
      ]
    }
  ]
}