429 rate_limited and a Retry-After header with the seconds to wait.
Staying under it
- Queue many calls with one
POST /v1/batches(up to 1,000 rows) instead of 1,000POST /v1/calls. - Use webhooks instead of polling
GET /v1/calls/{id}. - When you must poll, poll a batch (
GET /v1/batches/{id}) every 30–60 seconds, not each call.