Skip to main content

Submit async bulk job

POST 

/v2/jobs

Submit a large batch of addresses or coordinates for asynchronous processing. Returns a job ID that can be polled for progress and results.

Job types:

  • validate: look up GhanaPostGPS codes (addresses).
  • reverse: find the address at each point (coordinates).
  • address_validate: check each address for delivery, as POST /v2/address/validate does (items). Each result is a BulkAddressValidateResult. valid_count counts accept and confirm verdicts; error_count counts fix verdicts and rows that could not be checked.

Plan limits (max rows per job):

  • Free: not available
  • Basic: 1,000
  • Pro: 5,000
  • Enterprise: 10,000

Idempotency: Pass an Idempotency-Key header to prevent duplicate submissions. If the same key is used again, the existing job is returned instead of creating a new one.

Request​

Responses​

Duplicate submission — existing job returned (idempotency key matched)