GuidesAPI Reference
Guides

Get job status

The user wants to obtain the current status of a job created by an earlier request. For information on how to submit a job, see Geocoding and Reverse geocoding.

Request

The GET request below uses a jobId from an earlier request to retrieve that request's status. You need to use the jobId from your own request.

GET https://batch.search.hereapi.com/v7/batch/jobs/<jobId>

With cURL assuming jobId is in environment from earlier request. Variable YOUR_API_KEY has also to be set:

curl --request 'GET' \
  "https://batch.search.hereapi.com/v7/batch/jobs/${jobId}?apiKey=${YOUR_API_KEY}" \
  --header 'accept: application/json'

Response

{
  "id": "<jobId>",
  "serviceHrn": "hrn:here:service::olp-here:search-revgeocode-7",
  "billingTags": [],
  "status": "completed",
  "href": "https://batch.search.hereapi.com/v7/batch/jobs/<jobId>",
  "created": "2025-08-05T16:35:05.786211Z",
  "started": "2025-08-05T16:35:13.595589Z",
  "ended": "2025-08-05T16:35:26.710552Z",
  "records": {
    "total": 10,
    "valid": 10,
    "invalid": 0,
    "processed": 10,
    "pending": 0,
    "succeeded": 10,
    "failed": 0
  },
  "resultsHref": "https://batch.search.hereapi.com/v7/batch/jobs/<jobId>/results",
  "errorsHref": "",
  "outputType": "csv"
}

Related information