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.
Plan limits (max rows per job):
- Free: not available
- Starter: 500
- Professional: 5,000
- Team: 100,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
- 200
- 201
- 400
- 403
- 429
Duplicate submission — existing job returned (idempotency key matched)
Job created successfully
Invalid request
Plan does not support async jobs
Rate limit exceeded
Response Headers
X-RateLimit-Limit
Maximum requests allowed in the window
X-RateLimit-Remaining
Requests remaining in current window
Retry-After
Seconds until the rate limit resets