Documentation

Sim7 API

One endpoint to buy, one for status, one for the incoming SMS. Every request goes to https://sim7.org/api/v1 and is authorized with a bearer token.

Base URL

base_url

https://sim7.org/api/v1

HTTPS only, request and response bodies are JSON in UTF-8.

Authorization header

Bearer

Authorization

Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The key is available under API keys in your dashboard. Live keys use the s7_live format and charge the real balance.

Getting started

Base URL, JSON envelopes, and the first safe request.

Send HTTPS requests to https://sim7.org/api/v1. Successful responses use {"data": ...}; errors use {"error":{"code":"...","message":"..."}}.

Amounts are decimal US dollars rounded to four places. Timestamps are UTC ISO 8601 strings. Unknown fields in mutation bodies are rejected.

Authentication

Hashed production keys with least-privilege scopes.

Send Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Create keys in the dashboard. The complete bearer value is shown only once; Sim7 stores only its SHA-256 digest.

Every key is a production key: purchases contact a number supplier and charge the real account balance. Use a dedicated key with only the scopes and IP ranges your integration needs.

Scopes are catalog:read, account:read, orders:read, orders:write, and webhooks:write. An optional IPv4/IPv6/CIDR allowlist can be set per key.

Catalog and pricing

Services, countries, marked-up price, stock, and 24-hour success rate.

Service and country lists come from the local catalog snapshot. Prices already include the Sim7 markup and do not expose upstream supplier identity.

Refresh price and availability immediately before a purchase and use max_price to protect against a concurrent price change.

GET/services

List services

Service catalog with marked-up minimum price and aggregate stock.

Parameters

Parameter	Where	Type	Example:
categoryOptional	Query	string	Exact category ID.Example: `messengers`
searchOptional	Query	string	Case-insensitive ID/name search.Example: `tele`

categoryQueryOptional
Exact category ID.
string · Example: messengers
searchQueryOptional
Case-insensitive ID/name search.
string · Example: tele

curl

curl -s "https://sim7.org/api/v1/services?search=tele" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"telegram","name":"Telegram","category":"messengers","price_from":0.12,"available":48210}],"total":1}}

GET/countries

List countries

Country slugs, localized names, dial codes, and aggregate stock.

curl

curl -s https://sim7.org/api/v1/countries \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"germany","name_en":"Germany","name_ru":"Германия","iso":"DE","dial":"+49","available":27600}],"total":1}}

GET/prices

Prices and availability

Sell price, stock, and reported 24-hour success percentage by route.

Parameters

Parameter	Where	Type	Example:
serviceRequired	Query	string	Service ID.Example: `telegram`
countryOptional	Query	string	Optional country slug.Example: `germany`

serviceQueryRequired
Service ID.
string · Example: telegram
countryQueryOptional
Optional country slug.
string · Example: germany

curl

curl -s "https://sim7.org/api/v1/prices?service=telegram&country=germany" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"service":"telegram","items":[{"country":"germany","operator":"virtual51","price":0.12,"available":18240,"success_rate_24h_percent":97.8}]}}

Orders

Idempotent purchase and lifecycle actions with opaque Sim7 order IDs.

Every state-changing public API request requires a unique Idempotency-Key (8–128 safe characters). Repeating the exact request returns the stored response; reusing the key for different input returns idempotency_conflict.

Completed idempotency responses are retained for seven days. After that window, use a new key only for a genuinely new operation. Uncertain operations stay locked and require support reconciliation.

Pre-allocation errors such as insufficient_funds, no_numbers_available, price_changed, or a rate/concurrency limit release the reservation. After fixing the condition, retry the same request with the same Idempotency-Key.

If a purchase result is uncertain, the key remains blocked instead of risking a second charge. Keep the original idempotency key and contact support with it; do not start a replacement purchase blindly.

After an idempotency_in_progress result for an order action, read the order to reconcile its current state. For a webhook configuration change, read /webhook and rotate the signing secret if its one-time value was lost. Purchase creation is different: never replace its key while the outcome is uncertain.

Statuses are waiting, code_received, completed, cancelled, banned, and expired. Finish is valid after a code; cancel or ban is valid while waiting, subject to the route's provider cooldown.

Order status reads use a 20-second provider-poll lease. Concurrent reads return the latest local snapshot; supplier checks are additionally capped at 60 per account per minute.

POST/numbers

Buy a number

Creates a production purchase and charges the account balance.

Parameters

Parameter	Where	Type	Example:
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
serviceRequired	Body	string	Service ID.Example: `telegram`
countryRequired	Body	string	Country slug.Example: `germany`
operatorOptional	Body	string	Exact operator; omit or use any to choose the strongest eligible route.Example: `any`
max_priceOptional	Body	number	Maximum accepted final USD price.Example: `0.2`

Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
serviceBodyRequired
Service ID.
string · Example: telegram
countryBodyRequired
Country slug.
string · Example: germany
operatorBodyOptional
Exact operator; omit or use any to choose the strongest eligible route.
string · Example: any
max_priceBodyOptional
Maximum accepted final USD price.
number · Example: 0.2

curl

curl -s -X POST https://sim7.org/api/v1/numbers \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram","country":"germany","max_price":0.2}'

request.json

{"service":"telegram","country":"germany","operator":"any","max_price":0.2}

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders/{order_id}

Order status and messages

Refreshes an owned order and returns its current state.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders

Order history

Cursor-paginated API-created orders for this account.

Parameters

Parameter	Where	Type	Example:
statusOptional	Query	string	One documented order status.Example: `completed`
limitOptional	Query	number	1–100, default 20.Example: `20`
cursorOptional	Query	string	next_cursor from the previous response.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`

statusQueryOptional
One documented order status.
string · Example: completed
limitQueryOptional
1–100, default 20.
number · Example: 20
cursorQueryOptional
next_cursor from the previous response.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s "https://sim7.org/api/v1/orders?status=completed&limit=20" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }],"next_cursor":null}}

POST/orders/{order_id}/cancel

Cancel an order

Closes a waiting order; the trusted lifecycle applies any eligible refund exactly once.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/cancel \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/finish

Finish an order

Confirms an order after a code arrives.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/finish \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/ban

Ban a number

Closes a waiting order; the trusted lifecycle applies any eligible refund exactly once.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/ban \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

Account

Balance and the fixed limits applied to the account.

The account endpoint includes identity, active API orders, the real USD balance, and the fixed account-wide limit of 600 requests per minute. Multiple keys share this limit and cannot increase it.

GET/account

Account and limits

Account identity, production balance, and applied limits.

curl

curl -s https://sim7.org/api/v1/account \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"account_id":"user_id","email":"user@example.com","environment":"live","balance":42.5,"currency":"USD","charges_real_balance":true,"limits":{"concurrent_orders":250,"active_orders":3,"requests_per_minute":600}}}

GET/balance

Balance

Small response with the real account balance.

curl

curl -s https://sim7.org/api/v1/balance \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"balance":42.5,"currency":"USD","environment":"live","charges_real_balance":true}}

Webhooks

HMAC-signed, retryable outbound order events.

Configure an HTTPS endpoint and events with PUT /webhook or under Dashboard → API keys. Rotate its secret in the dashboard. The signing secret is shown only when the endpoint is created or rotated.

Parse X-Sim7-Signature as v1=<lowercase hex> and verify the hex as HMAC-SHA256(secret, timestamp + "." + rawBody), where timestamp is the exact X-Sim7-Timestamp value. X-Sim7-Secret-Version identifies which retained secret verifies the delivery. Compare in constant time and reject stale timestamps.

Delivery is at least once. Sim7 accepts any 2xx response within five seconds and makes five attempts total: the initial request plus four retries after 10 s, 30 s, 2 min, and 5 min. Use X-Sim7-Delivery as your deduplication key.

A queued delivery keeps the secret version captured when it was created. Every retry gets a fresh timestamp and signature using that same secret version. Keep the previous secret until old queued deliveries have drained after rotation.

Events are delivered in creation order per endpoint. One slow endpoint uses at most one global worker slot, and its non-terminal queue is capped at 500 events. Disabling delivery cancels its queued attempts; events produced while disabled or before endpoint creation are not backfilled when it is enabled.

Delivered and permanently failed delivery logs are retained for 30 days. Pending and in-flight deliveries are not removed by retention cleanup.

GET/webhook

Read webhook configuration

Returns this key's endpoint without its signing secret.

curl

curl -s https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z"}}

PUT/webhook

Create or update a webhook

Validates a public HTTPS target. secret is returned only on first creation; an idempotent replay redacts it.

Parameters

Parameter	Where	Type	Example:
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
urlRequired	Body	string	Public HTTPS URL on port 443.Example: `https://example.com/webhooks/sim7`
eventsRequired	Body	string[]	Array of documented event names.Example: `["order.code_received"]`
is_enabledOptional	Body	boolean	Disable or enable future deliveries. Disabling cancels queued attempts and does not backfill missed events.Example: `true`

Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
urlBodyRequired
Public HTTPS URL on port 443.
string · Example: https://example.com/webhooks/sim7
eventsBodyRequired
Array of documented event names.
string[] · Example: ["order.code_received"]
is_enabledBodyOptional
Disable or enable future deliveries. Disabling cancels queued attempts and does not backfill missed events.
boolean · Example: true

curl

curl -s -X PUT https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" -H "Content-Type: application/json" -d '{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}'

request.json

{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z","secret":"whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}}

DELETE/webhook

Delete a webhook

Stops delivery and deletes queued delivery logs for this endpoint.

Parameters

Parameter	Where	Type	Example:
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X DELETE https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{"data":{"deleted":true}}

GET/webhook/deliveries

Webhook delivery log

Returns the latest 50 delivery records without request payloads or secrets.

curl

curl -s https://sim7.org/api/v1/webhook/deliveries -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"delivery_id","event":"order.code_received","status":"delivered","attempts":1,"response_status":204,"secret_version":1}]}}

POSThttps://example.com/webhooks/sim7

Outbound event payload

Example request sent by Sim7; this is your endpoint, not a Sim7 API route.

curl

# Signature input: <X-Sim7-Timestamp>.<raw JSON body>
# Headers: X-Sim7-Delivery, X-Sim7-Event, X-Sim7-Timestamp, X-Sim7-Signature, X-Sim7-Secret-Version

request.json

{"id":"delivery_id","event":"order.code_received","created_at":"2026-09-03T18:12:44.000Z","data":{"order_id":"ord_xxxxxxxxxxxxxxxxxxxxxx","number":"+12025550142 901 234 56 78","code":"482913","status":"code_received"}}

response.json

HTTP/1.1 204 No Content

Errors and limits

Stable machine codes and configurable per-key request limits.

Branch on error.code. Retry 429 and transient 5xx with backoff. Do not retry a 4xx unchanged, and do not replace an uncertain purchase's idempotency key.

Error codes

Sim7 API error codes
Code	HTTP	What happened
`invalid_request`	400	Invalid requestA parameter, JSON body, content type, or body size is invalid.
`invalid_idempotency_key`	400	Invalid idempotency keyA state-changing request lacks a valid Idempotency-Key.
`unauthorized`	401	Key not acceptedThe bearer key is missing, malformed, expired, revoked, or invalid.
`insufficient_funds`	402	Insufficient fundsThe live balance cannot cover the selected route.
`ip_not_allowed`	403	IP not allowedThe request IP is outside this key's allowlist.
`scope_forbidden`	403	Scope missingThe key does not grant the endpoint's scope.
`order_not_found`	404	Order not foundThe opaque ID is unknown or belongs to another user.
`no_numbers_available`	409	No numbersNo in-stock route matches the request.
`price_changed`	409	Price changedThe final price exceeds max_price.
`order_not_actionable`	409	Action unavailableThe order state does not permit this lifecycle action.
`idempotency_conflict`	409	Idempotency conflictThe key was used for different input.
`idempotency_in_progress`	409	Result uncertainThe original operation is running or its result needs support reconciliation.
`rate_limited`	429	Rate limitedThe per-key or abuse-protection limit was exceeded.
`concurrency_limit`	429	Too many active ordersClose an active order before creating another.
`internal_error`	500	Internal errorA safe generic response; no provider detail is exposed.
`service_unavailable`	503	UnavailableA required dependency is temporarily unavailable.
`purchase_reconciliation_required`	503	Purchase reconciliation requiredA number may have been allocated but its compensating cancellation was not confirmed. Keep the original Idempotency-Key and contact support; never start a replacement blindly.

invalid_request400
Invalid request
A parameter, JSON body, content type, or body size is invalid.
invalid_idempotency_key400
Invalid idempotency key
A state-changing request lacks a valid Idempotency-Key.
unauthorized401
Key not accepted
The bearer key is missing, malformed, expired, revoked, or invalid.
insufficient_funds402
Insufficient funds
The live balance cannot cover the selected route.
ip_not_allowed403
IP not allowed
The request IP is outside this key's allowlist.
scope_forbidden403
Scope missing
The key does not grant the endpoint's scope.
order_not_found404
Order not found
The opaque ID is unknown or belongs to another user.
no_numbers_available409
No numbers
No in-stock route matches the request.
price_changed409
Price changed
The final price exceeds max_price.
order_not_actionable409
Action unavailable
The order state does not permit this lifecycle action.
idempotency_conflict409
Idempotency conflict
The key was used for different input.
idempotency_in_progress409
Result uncertain
The original operation is running or its result needs support reconciliation.
rate_limited429
Rate limited
The per-key or abuse-protection limit was exceeded.
concurrency_limit429
Too many active orders
Close an active order before creating another.
internal_error500
Internal error
A safe generic response; no provider detail is exposed.
service_unavailable503
Unavailable
A required dependency is temporarily unavailable.
purchase_reconciliation_required503
Purchase reconciliation required
A number may have been allocated but its compensating cancellation was not confirmed. Keep the original Idempotency-Key and contact support; never start a replacement blindly.

Request rate

Per-plan request rate limits
Plan	Requests / min	Notes
All API requests	600	Fixed for the whole account and for each key. Creating more keys does not multiply the account limit.
Order creation ceiling	20	Applied independently per account, key, and trusted client IP; the general 600-request limit also applies.
Live supplier status checks	60 per account	A 20-second per-order lease outlives supplier timeouts and collapses concurrent GET requests into one check.

All API requests600
Fixed for the whole account and for each key. Creating more keys does not multiply the account limit.
Order creation ceiling20
Applied independently per account, key, and trusted client IP; the general 600-request limit also applies.
Live supplier status checks60 per account
A 20-second per-order lease outlives supplier timeouts and collapses concurrent GET requests into one check.

We publish the current state of every component and the incident history on the status page.

Ready to try it?

Create a production key in the dashboard. The 600-request-per-minute limit is fixed for the whole account, and webhook signatures are verified against the X-Sim7-Signature header.

Get an access key My API keys

Documentation

Sim7 API

One endpoint to buy, one for status, one for the incoming SMS. Every request goes to https://sim7.org/api/v1 and is authorized with a bearer token.

Base URL

base_url

https://sim7.org/api/v1

HTTPS only, request and response bodies are JSON in UTF-8.

Authorization header

Bearer

Authorization

Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The key is available under API keys in your dashboard. Live keys use the s7_live format and charge the real balance.

Getting started

Base URL, JSON envelopes, and the first safe request.

Send HTTPS requests to https://sim7.org/api/v1. Successful responses use {"data": ...}; errors use {"error":{"code":"...","message":"..."}}.

Amounts are decimal US dollars rounded to four places. Timestamps are UTC ISO 8601 strings. Unknown fields in mutation bodies are rejected.

Authentication

Hashed production keys with least-privilege scopes.

Every key is a production key: purchases contact a number supplier and charge the real account balance. Use a dedicated key with only the scopes and IP ranges your integration needs.

Scopes are catalog:read, account:read, orders:read, orders:write, and webhooks:write. An optional IPv4/IPv6/CIDR allowlist can be set per key.

Catalog and pricing

Services, countries, marked-up price, stock, and 24-hour success rate.

Service and country lists come from the local catalog snapshot. Prices already include the Sim7 markup and do not expose upstream supplier identity.

Refresh price and availability immediately before a purchase and use max_price to protect against a concurrent price change.

GET/services

List services

Service catalog with marked-up minimum price and aggregate stock.

Parameters

Parameter	Where	Type	Example:
categoryOptional	Query	string	Exact category ID.Example: `messengers`
searchOptional	Query	string	Case-insensitive ID/name search.Example: `tele`

categoryQueryOptional
Exact category ID.
string · Example: messengers
searchQueryOptional
Case-insensitive ID/name search.
string · Example: tele

curl

curl -s "https://sim7.org/api/v1/services?search=tele" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"telegram","name":"Telegram","category":"messengers","price_from":0.12,"available":48210}],"total":1}}

GET/countries

List countries

Country slugs, localized names, dial codes, and aggregate stock.

curl

curl -s https://sim7.org/api/v1/countries \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"germany","name_en":"Germany","name_ru":"Германия","iso":"DE","dial":"+49","available":27600}],"total":1}}

GET/prices

Prices and availability

Sell price, stock, and reported 24-hour success percentage by route.

Parameters

Parameter	Where	Type	Example:
serviceRequired	Query	string	Service ID.Example: `telegram`
countryOptional	Query	string	Optional country slug.Example: `germany`

serviceQueryRequired
Service ID.
string · Example: telegram
countryQueryOptional
Optional country slug.
string · Example: germany

curl

curl -s "https://sim7.org/api/v1/prices?service=telegram&country=germany" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"service":"telegram","items":[{"country":"germany","operator":"virtual51","price":0.12,"available":18240,"success_rate_24h_percent":97.8}]}}

Orders

Idempotent purchase and lifecycle actions with opaque Sim7 order IDs.

Completed idempotency responses are retained for seven days. After that window, use a new key only for a genuinely new operation. Uncertain operations stay locked and require support reconciliation.

Statuses are waiting, code_received, completed, cancelled, banned, and expired. Finish is valid after a code; cancel or ban is valid while waiting, subject to the route's provider cooldown.

Order status reads use a 20-second provider-poll lease. Concurrent reads return the latest local snapshot; supplier checks are additionally capped at 60 per account per minute.

POST/numbers

Buy a number

Creates a production purchase and charges the account balance.

Parameters

Parameter	Where	Type	Example:
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
serviceRequired	Body	string	Service ID.Example: `telegram`
countryRequired	Body	string	Country slug.Example: `germany`
operatorOptional	Body	string	Exact operator; omit or use any to choose the strongest eligible route.Example: `any`
max_priceOptional	Body	number	Maximum accepted final USD price.Example: `0.2`

Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
serviceBodyRequired
Service ID.
string · Example: telegram
countryBodyRequired
Country slug.
string · Example: germany
operatorBodyOptional
Exact operator; omit or use any to choose the strongest eligible route.
string · Example: any
max_priceBodyOptional
Maximum accepted final USD price.
number · Example: 0.2

curl

curl -s -X POST https://sim7.org/api/v1/numbers \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram","country":"germany","max_price":0.2}'

request.json

{"service":"telegram","country":"germany","operator":"any","max_price":0.2}

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders/{order_id}

Order status and messages

Refreshes an owned order and returns its current state.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders

Order history

Cursor-paginated API-created orders for this account.

Parameters

Parameter	Where	Type	Example:
statusOptional	Query	string	One documented order status.Example: `completed`
limitOptional	Query	number	1–100, default 20.Example: `20`
cursorOptional	Query	string	next_cursor from the previous response.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`

statusQueryOptional
One documented order status.
string · Example: completed
limitQueryOptional
1–100, default 20.
number · Example: 20
cursorQueryOptional
next_cursor from the previous response.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s "https://sim7.org/api/v1/orders?status=completed&limit=20" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }],"next_cursor":null}}

POST/orders/{order_id}/cancel

Cancel an order

Closes a waiting order; the trusted lifecycle applies any eligible refund exactly once.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/cancel \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/finish

Finish an order

Confirms an order after a code arrives.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/finish \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/ban

Ban a number

Closes a waiting order; the trusted lifecycle applies any eligible refund exactly once.

Parameters

Parameter	Where	Type	Example:
order_idRequired	Path	string	Opaque Sim7 order ID.Example: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idPathRequired
Opaque Sim7 order ID.
string · Example: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/ban \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

Account

Balance and the fixed limits applied to the account.

The account endpoint includes identity, active API orders, the real USD balance, and the fixed account-wide limit of 600 requests per minute. Multiple keys share this limit and cannot increase it.

GET/account

Account and limits

Account identity, production balance, and applied limits.

curl

curl -s https://sim7.org/api/v1/account \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"account_id":"user_id","email":"user@example.com","environment":"live","balance":42.5,"currency":"USD","charges_real_balance":true,"limits":{"concurrent_orders":250,"active_orders":3,"requests_per_minute":600}}}

GET/balance

Balance

Small response with the real account balance.

curl

curl -s https://sim7.org/api/v1/balance \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"balance":42.5,"currency":"USD","environment":"live","charges_real_balance":true}}

Webhooks

HMAC-signed, retryable outbound order events.

Configure an HTTPS endpoint and events with PUT /webhook or under Dashboard → API keys. Rotate its secret in the dashboard. The signing secret is shown only when the endpoint is created or rotated.

Delivered and permanently failed delivery logs are retained for 30 days. Pending and in-flight deliveries are not removed by retention cleanup.

GET/webhook

Read webhook configuration

Returns this key's endpoint without its signing secret.

curl

curl -s https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z"}}

PUT/webhook

Create or update a webhook

Validates a public HTTPS target. secret is returned only on first creation; an idempotent replay redacts it.

Parameters

Parameter	Where	Type	Example:
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
urlRequired	Body	string	Public HTTPS URL on port 443.Example: `https://example.com/webhooks/sim7`
eventsRequired	Body	string[]	Array of documented event names.Example: `["order.code_received"]`
is_enabledOptional	Body	boolean	Disable or enable future deliveries. Disabling cancels queued attempts and does not backfill missed events.Example: `true`

Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
urlBodyRequired
Public HTTPS URL on port 443.
string · Example: https://example.com/webhooks/sim7
eventsBodyRequired
Array of documented event names.
string[] · Example: ["order.code_received"]
is_enabledBodyOptional
Disable or enable future deliveries. Disabling cancels queued attempts and does not backfill missed events.
boolean · Example: true

curl

curl -s -X PUT https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" -H "Content-Type: application/json" -d '{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}'

request.json

{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z","secret":"whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}}

DELETE/webhook

Delete a webhook

Stops delivery and deletes queued delivery logs for this endpoint.

Parameters

Parameter	Where	Type	Example:
Idempotency-KeyRequired	Header	string	Unique key for this logical mutation.Example: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

Idempotency-KeyHeaderRequired
Unique key for this logical mutation.
string · Example: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X DELETE https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{"data":{"deleted":true}}

GET/webhook/deliveries

Webhook delivery log

Returns the latest 50 delivery records without request payloads or secrets.

curl

curl -s https://sim7.org/api/v1/webhook/deliveries -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"delivery_id","event":"order.code_received","status":"delivered","attempts":1,"response_status":204,"secret_version":1}]}}

POSThttps://example.com/webhooks/sim7

Outbound event payload

Example request sent by Sim7; this is your endpoint, not a Sim7 API route.

curl

# Signature input: <X-Sim7-Timestamp>.<raw JSON body>
# Headers: X-Sim7-Delivery, X-Sim7-Event, X-Sim7-Timestamp, X-Sim7-Signature, X-Sim7-Secret-Version

request.json

{"id":"delivery_id","event":"order.code_received","created_at":"2026-09-03T18:12:44.000Z","data":{"order_id":"ord_xxxxxxxxxxxxxxxxxxxxxx","number":"+12025550142 901 234 56 78","code":"482913","status":"code_received"}}

response.json

HTTP/1.1 204 No Content

Errors and limits

Stable machine codes and configurable per-key request limits.

Branch on error.code. Retry 429 and transient 5xx with backoff. Do not retry a 4xx unchanged, and do not replace an uncertain purchase's idempotency key.

Error codes

Sim7 API error codes
Code	HTTP	What happened
`invalid_request`	400	Invalid requestA parameter, JSON body, content type, or body size is invalid.
`invalid_idempotency_key`	400	Invalid idempotency keyA state-changing request lacks a valid Idempotency-Key.
`unauthorized`	401	Key not acceptedThe bearer key is missing, malformed, expired, revoked, or invalid.
`insufficient_funds`	402	Insufficient fundsThe live balance cannot cover the selected route.
`ip_not_allowed`	403	IP not allowedThe request IP is outside this key's allowlist.
`scope_forbidden`	403	Scope missingThe key does not grant the endpoint's scope.
`order_not_found`	404	Order not foundThe opaque ID is unknown or belongs to another user.
`no_numbers_available`	409	No numbersNo in-stock route matches the request.
`price_changed`	409	Price changedThe final price exceeds max_price.
`order_not_actionable`	409	Action unavailableThe order state does not permit this lifecycle action.
`idempotency_conflict`	409	Idempotency conflictThe key was used for different input.
`idempotency_in_progress`	409	Result uncertainThe original operation is running or its result needs support reconciliation.
`rate_limited`	429	Rate limitedThe per-key or abuse-protection limit was exceeded.
`concurrency_limit`	429	Too many active ordersClose an active order before creating another.
`internal_error`	500	Internal errorA safe generic response; no provider detail is exposed.
`service_unavailable`	503	UnavailableA required dependency is temporarily unavailable.
`purchase_reconciliation_required`	503	Purchase reconciliation requiredA number may have been allocated but its compensating cancellation was not confirmed. Keep the original Idempotency-Key and contact support; never start a replacement blindly.

invalid_request400
Invalid request
A parameter, JSON body, content type, or body size is invalid.
invalid_idempotency_key400
Invalid idempotency key
A state-changing request lacks a valid Idempotency-Key.
unauthorized401
Key not accepted
The bearer key is missing, malformed, expired, revoked, or invalid.
insufficient_funds402
Insufficient funds
The live balance cannot cover the selected route.
ip_not_allowed403
IP not allowed
The request IP is outside this key's allowlist.
scope_forbidden403
Scope missing
The key does not grant the endpoint's scope.
order_not_found404
Order not found
The opaque ID is unknown or belongs to another user.
no_numbers_available409
No numbers
No in-stock route matches the request.
price_changed409
Price changed
The final price exceeds max_price.
order_not_actionable409
Action unavailable
The order state does not permit this lifecycle action.
idempotency_conflict409
Idempotency conflict
The key was used for different input.
idempotency_in_progress409
Result uncertain
The original operation is running or its result needs support reconciliation.
rate_limited429
Rate limited
The per-key or abuse-protection limit was exceeded.
concurrency_limit429
Too many active orders
Close an active order before creating another.
internal_error500
Internal error
A safe generic response; no provider detail is exposed.
service_unavailable503
Unavailable
A required dependency is temporarily unavailable.
purchase_reconciliation_required503
Purchase reconciliation required
A number may have been allocated but its compensating cancellation was not confirmed. Keep the original Idempotency-Key and contact support; never start a replacement blindly.

Request rate

Per-plan request rate limits
Plan	Requests / min	Notes
All API requests	600	Fixed for the whole account and for each key. Creating more keys does not multiply the account limit.
Order creation ceiling	20	Applied independently per account, key, and trusted client IP; the general 600-request limit also applies.
Live supplier status checks	60 per account	A 20-second per-order lease outlives supplier timeouts and collapses concurrent GET requests into one check.

All API requests600
Fixed for the whole account and for each key. Creating more keys does not multiply the account limit.
Order creation ceiling20
Applied independently per account, key, and trusted client IP; the general 600-request limit also applies.
Live supplier status checks60 per account
A 20-second per-order lease outlives supplier timeouts and collapses concurrent GET requests into one check.

We publish the current state of every component and the incident history on the status page.

Ready to try it?

Create a production key in the dashboard. The 600-request-per-minute limit is fixed for the whole account, and webhook signatures are verified against the X-Sim7-Signature header.

Get an access key My API keys