What rate limits apply to bulk provisioning?

60 requests/minute per client_id by default. Bulk endpoints accept up to 100 eSIMs per call. Use Idempotency-Key on every request to make retries safe.

The short answer

60 requests per minute per
```
client_id
```
by default
100 eSIMs per call on the bulk endpoint
Hit either and you get
```
429
```
with a
```
Retry-After
```
header

Sizing your job

Try it yourself

Free sandbox. Real Tier-1 carriers. 60 seconds from signup to credentials.

Get started →

If you need to provision 1,000 eSIMs:

10 bulk calls of 100 each
Spread over 10 minutes minimum (well under the 60/min cap)
Realistic wall time: 2 to 4 minutes including activation webhooks

Required headers for safety

Always send an

Idempotency-Key

on every write. Use a deterministic value like

batch_42_chunk_3

so a retry returns the original response instead of creating duplicates.

bash
curl -X POST https://connect.firsty.app/api/v3/esims/bulk \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: batch_42_chunk_3" \
  -H "Content-Type: application/json" \
  -d '{"items":[...]}'

If you need more throughput

Email builders@firsty.app with your expected peak QPS. Production accounts can be raised to 600/min on request. Above that we set up a dedicated queue.

See the bulk provisioning guide for the full backoff pattern.

Was this helpful?

Related help