Batch Geocoder API Developer's Guide

Job Status

After a job has been submitted the job status can be checked with a GET request and parameter action=status. The job status can be one of: submitted, accepted, running, completed, cancelled, deleted, or failed.

Job submitted and accepted

Status = accepted.

All counts are still 0.

A job can also be submitted via POST (upload of the input data) without starting it right away.

To do this do not specify the parameter action=run. The status in this case is submitted. Start the job later with a PUT request and action=run.

Job started running

Status = running.

JobStatus shows start time.

Counts may show 0 at first but will show counts as soon as first records are processed.

Job is still running

Status = running.

JobStatus shows start time.

Counts now reflect job progress.

Job is running and nearly done

Status = running.

Counts show all records have been processed, i.e. total count = processed count.

Results are being sorted and results ZIP file is being created.

Job is completed

Status = completed.

JobFinished shows time when job has completed.

Counts show stats for job.

Files of job are ready for download.

Job is cancelled

Status = cancelled.

Job was cancelled by user with HTTP PUT command action=cancel.

Counts show stats for job at time of cancellation. Job results are not available for download.

Job is deleted

Status = deleted.

Job was deleted by user with HTTP DELETE command.

Counts show stats for job at time of deletion. Job results are not available for download anymore.

Files are removed from the Geocoder's systems. Note: Jobs are automatically removed from the server 30 days after they are processed.

Job failed

Status = failed.

Job failed while running. This is unusual and caused by an internal error. You can try to restart the job with a PUT request and action=run or delete the job.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.