Batch Geocoder API Developer's Guide

API Endpoints

Table 1. Batch Geocoder Request Endpoints
URL Request Description HTTP Method
jobs

<The HTTP Body of the request contains the data to be geocoded.>

  • Creates a batch job
  • Returns a RequestID
POST
jobs/{REQUEST_ID}?action=run&params=... Starts the batch job with the given parameters. PUT
jobs?action=run&params=...

<The HTTP Body of the request contains the data to be geocoded.>

  • Creates a batch job
  • Starts the job
  • Returns a RequestID
(shortcut for jobs and jobs/...?action=run)
POST
jobs/{REQUEST_ID}?action=cancel Cancels the batch job. PUT
jobs/{REQUEST_ID}?action=status Returns the status for the batch job . GET
jobs/{REQUEST_ID} Deletes the batch job.

Note that the difference between this request and others is the HTTP type, which is DELETE. You do not use an action to delete a job.

DELETE
jobs/{REQUEST_ID}/result Starts a download of all files.

The result file contains all geocoded results. If "OutputCombined" is specified, this will also contain "no-matches". Errors are not included.

GET
jobs/{REQUEST_ID}/errors Starts a download of the error file.

The errors file contains all invalid lines from the input data.

GET
jobs/{REQUEST_ID}/no-matches Download all results that the geocoder could not match to an address ("no-match")

Downloads the no-matches file only.

GET
jobs/{REQUEST_ID}/all Downloads all available files in one zip file
Downloads all the files:
  • result,
  • errors (optional)
  • invalid
  • report
GET