Developers
Submit a customer API job
Keys, idempotency, caps and result pagination.
Use a scoped key
Create a Test key to simulate reserved example addresses with no provider call or credit use. Keep live keys on your server. Assign only the submit, read or balance scopes you need.
The live key cap counts credits charged plus accepted reservations. If the cap is reached, a new job is refused without creating a hold.
Safe retries
Send a stable Idempotency-Key with a job. A matching retry returns the same job. Use the returned job ID to read state and paginated results. A repeated key with a different payload is rejected.
Live submissions remain closed while the verification launch gate is closed. Test keys continue to support sandbox jobs.