{ "item": [ { "name": "Orders", "description": "Buy or cancel a number; track lifecycle by polling or through webhooks.", "item": [ { "id": "77e05743-6ca0-4559-a7f5-0e411b8c059e", "name": "List your orders", "request": { "name": "List your orders", "description": { "content": "Available to every account by default — this is the recommended\npolling endpoint. One `GET /orders?status=pending,active` every\n5 seconds tracks all your in-flight orders with a single request.\n\n`403 ORDER_QUERY_NOT_AVAILABLE` is returned only when polling has\nbeen disabled for your account (e.g. abuse review) — contact support.\n", "type": "text/plain" }, "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page size, max 100.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" }, { "disabled": true, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "startTime", "value": "" }, { "disabled": true, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "endTime", "value": "" }, { "disabled": true, "description": { "content": "Comma-separated order statuses, e.g. `active,completed`.", "type": "text/plain" }, "key": "status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c9b2e91d-4ae2-41f9-853a-bada72a388f7", "name": "Order list, newest first.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page size, max 100.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" }, { "disabled": false, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "startTime", "value": "" }, { "disabled": false, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "endTime", "value": "" }, { "disabled": false, "description": { "content": "Comma-separated order statuses, e.g. `active,completed`.", "type": "text/plain" }, "key": "status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"items\": [\n {\n \"id\": \"\",\n \"order_no\": \"\",\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"status\": \"active\",\n \"amount_cents\": \"\",\n \"currency\": \"\",\n \"phone_number\": \"\",\n \"sms_code\": \"\",\n \"sms_content\": \"\",\n \"created_at\": \"\",\n \"activated_at\": \"\",\n \"expired_at\": \"\",\n \"completed_at\": \"\",\n \"cancelled_at\": \"\",\n \"sms_received_at\": \"\",\n \"error_code\": \"\",\n \"error_message\": \"\"\n },\n {\n \"id\": \"\",\n \"order_no\": \"\",\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"status\": \"completed\",\n \"amount_cents\": \"\",\n \"currency\": \"\",\n \"phone_number\": \"\",\n \"sms_code\": \"\",\n \"sms_content\": \"\",\n \"created_at\": \"\",\n \"activated_at\": \"\",\n \"expired_at\": \"\",\n \"completed_at\": \"\",\n \"cancelled_at\": \"\",\n \"sms_received_at\": \"\",\n \"error_code\": \"\",\n \"error_message\": \"\"\n }\n ],\n \"total\": \"\",\n \"limit\": \"\",\n \"offset\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4821444-1948-49a5-b295-d5757e99847a", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page size, max 100.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" }, { "disabled": false, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "startTime", "value": "" }, { "disabled": false, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "endTime", "value": "" }, { "disabled": false, "description": { "content": "Comma-separated order statuses, e.g. `active,completed`.", "type": "text/plain" }, "key": "status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "762adbaa-1733-446c-b01e-898d862bc2c7", "name": "`ORDER_QUERY_NOT_AVAILABLE` — order status polling has been disabled for your account (e.g. abuse review). Polling is enabled by default for all accounts; contact support to restore access.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Page size, max 100.", "type": "text/plain" }, "key": "limit", "value": "20" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" }, { "disabled": false, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "startTime", "value": "" }, { "disabled": false, "description": { "content": "RFC3339; filters by `created_at`.", "type": "text/plain" }, "key": "endTime", "value": "" }, { "disabled": false, "description": { "content": "Comma-separated order statuses, e.g. `active,completed`.", "type": "text/plain" }, "key": "status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b5bb3583-27a3-4da2-9a0b-a36d11cf0793", "name": "Create an order (buy a number)", "request": { "name": "Create an order (buy a number)", "description": { "content": "Buys a temporary number for the given service and country. The order\nstays `pending` until a number is allocated (usually within seconds),\nthen becomes `active`; when the SMS code arrives it becomes\n`completed`.\n\n**Billing**: your wallet is charged **when the number is successfully\nallocated**, not at creation — while the order is `pending`,\n`amount_cents` is `0` and no funds have moved. If allocation fails\n(`failed`), you are never charged.\n\n**Price is resolved server-side** from the current catalog — you\ncannot self-quote. Pass `max_price_cents` to protect against price\nmoves between your catalog read and the purchase: if the resolved\nprice exceeds your cap by **more than 5%**, a `412 PRICE_CHANGED`\nis returned instead of charging you. Note the 5% tolerance — with\n`max_price_cents: 100` you may still be charged up to 105 cents;\ntreat it as drift protection, not an exact budget ceiling.\n\nSupports idempotency: pass a UUID in the `Idempotency-Key` header;\nretrying with the same key returns the original order (with its\ncurrent live status) instead of buying twice.\n\nReceive the allocated number and SMS code by polling\n`GET /orders` / `GET /orders/{id}`, or through the\n`order.number_allocated` and `order.completed` webhook events.\n\nAccounts with polling disabled (abuse review) instead get a fixed\n`pending` creation acknowledgement (`amount_cents: 0`) without\nphone/SMS/live status — even on idempotent replay — and receive all\nlifecycle updates through webhooks.\n", "type": "text/plain" }, "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Optional. Enable and set a real UUID to make retries idempotent.", "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"whatsapp\",\n \"country_code\": \"US\"\n}\n", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f0ac2d69-6795-4bef-a099-d4807703738f", "name": "Order accepted (`pending`). Track it by polling or webhooks. For accounts with polling disabled (abuse review) this is a fixed creation acknowledgement even on idempotent replay: no phone, SMS, live status, or settled amount is returned.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"order_no\": \"\",\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"status\": \"pending\",\n \"amount_cents\": \"\",\n \"currency\": \"\",\n \"phone_number\": \"\",\n \"sms_code\": \"\",\n \"sms_content\": \"\",\n \"created_at\": \"\",\n \"activated_at\": \"\",\n \"expired_at\": \"\",\n \"completed_at\": \"\",\n \"cancelled_at\": \"\",\n \"sms_received_at\": \"\",\n \"error_code\": \"\",\n \"error_message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03fa79ce-b49e-47da-b13d-4beec9aaa181", "name": "Validation error (`VALIDATION_ERROR`, `CURRENCY_MISMATCH`).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c925d72-a661-41a3-be27-4e083085cc37", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a89c709a-983e-49f8-8fe1-34351e8abc61", "name": "Key is valid but the account is not eligible (`ACCOUNT_BANNED`, `EMAIL_NOT_VERIFIED`, `ACCOUNT_NOT_ACTIVE`). Emitted by the auth layer — flat shape.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49ec8e80-2d3c-45b6-a961-0bed5472b9df", "name": "`PRICE_CHANGED` — current price exceeds your `max_price_cents`; re-read the catalog and retry.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Precondition Failed", "code": 412, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef94945a-9391-40ae-87db-810f7f5545a6", "name": "`INSUFFICIENT_BALANCE`, `WALLET_NOT_INITIALIZED`, or `SERVICE_NOT_AVAILABLE`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dec1dac4-535a-41c0-bb0c-2140db3b18f3", "name": "Branch on `code` and honour `Retry-After`:\n- `RATE_LIMITED` / `RATE_LIMITED_DAILY`: wait until the indicated reset.\n- `TOO_MANY_ACTIVE_ORDERS`: wait for current orders to finish.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID; retries with the same key return the original order.", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"tier\": \"premium\",\n \"max_price_cents\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b446f2d3-6fb4-47f4-bff8-c6f938d48d50", "name": "Get a single order", "request": { "name": "Get a single order", "description": { "content": "Available by default, same as `GET /orders`. Prefer list polling to\ntrack many orders — poll this endpoint only for a single order of\ninterest.\n", "type": "text/plain" }, "url": { "path": [ "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "645a3b2c-3bed-487f-a147-019cfd1dd43e", "name": "The order.", "originalRequest": { "url": { "path": [ "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"order_no\": \"\",\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"status\": \"pending\",\n \"amount_cents\": \"\",\n \"currency\": \"\",\n \"phone_number\": \"\",\n \"sms_code\": \"\",\n \"sms_content\": \"\",\n \"created_at\": \"\",\n \"activated_at\": \"\",\n \"expired_at\": \"\",\n \"completed_at\": \"\",\n \"cancelled_at\": \"\",\n \"sms_received_at\": \"\",\n \"error_code\": \"\",\n \"error_message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29e10090-b850-4ab6-8015-d4b6afca1e13", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d47ae0e-a1e7-4d18-82d5-b94ff631f263", "name": "`ORDER_QUERY_NOT_AVAILABLE` — order status polling has been disabled for your account (e.g. abuse review). Polling is enabled by default for all accounts; contact support to restore access.", "originalRequest": { "url": { "path": [ "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6801cb5-b234-415f-adfe-5ad142c5d593", "name": "`ORDER_NOT_FOUND` — no such order under your account.", "originalRequest": { "url": { "path": [ "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6903b369-182f-4681-acbe-d39e2d51993b", "name": "Cancel an order (refund)", "request": { "name": "Cancel an order (refund)", "description": { "content": "Cancels an order that has not received an SMS yet. If the number was\nalready allocated (order charged), the charge is refunded; a still\n`pending` order was never charged. Allowed only after a 2-minute\ncooldown from creation (`422 CANCEL_TOO_EARLY` before that).\nCancellation may be temporarily refused while the SMS could still be\nin transit (`409 CANCEL_DENIED_RETRY_LATER`) — the order stays\n`active` and keeps waiting for the SMS; retry in a few minutes or let\nthe order expire for an automatic refund.\n\nCancelling an order that is **already terminal** returns `200` with\nthe order's full current state (idempotent replay) — **always check\n`status` in the response**: a `completed` order was charged and is\nNOT refunded by this call; only `status: cancelled` means the charge\nwas released.\nFor accounts with polling disabled (abuse review), the terminal case\nreturns `409 ORDER_ALREADY_TERMINAL` instead, and a successful\ncancellation returns a fixed `cancelled` acknowledgement\n(`amount_cents: 0`) without phone/SMS/live fields.\n", "type": "text/plain" }, "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "c7af86d0-a33b-4acb-9111-63367acb4bde", "name": "Cancellation accepted, or idempotent replay for an already-terminal order — branch on `status`: `cancelled` = charge released; `completed` = SMS was delivered and the charge stands. For accounts with polling disabled (abuse review), this is a fixed `cancelled` acknowledgement without phone, SMS, settled amount, or other live fields.", "originalRequest": { "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"order_no\": \"\",\n \"service_code\": \"\",\n \"country_code\": \"\",\n \"status\": \"pending\",\n \"amount_cents\": \"\",\n \"currency\": \"\",\n \"phone_number\": \"\",\n \"sms_code\": \"\",\n \"sms_content\": \"\",\n \"created_at\": \"\",\n \"activated_at\": \"\",\n \"expired_at\": \"\",\n \"completed_at\": \"\",\n \"cancelled_at\": \"\",\n \"sms_received_at\": \"\",\n \"error_code\": \"\",\n \"error_message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee62448e-4f0e-4509-8f2c-10d25a279358", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65073b33-b08c-4e2f-b12f-cf2d58dce496", "name": "Key is valid but the account is not eligible (`ACCOUNT_BANNED`, `EMAIL_NOT_VERIFIED`, `ACCOUNT_NOT_ACTIVE`). Emitted by the auth layer — flat shape.", "originalRequest": { "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc2e5a78-104c-49da-9ca9-b6ca3c593b76", "name": "`ORDER_NOT_FOUND` — no such order under your account.", "originalRequest": { "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d29a8eb5-fef2-47c9-ac07-bac74dc74b9e", "name": "`CANCEL_DENIED_RETRY_LATER` — cancellation temporarily unavailable (SMS may still arrive), order stays active, retry in a few minutes; or `ORDER_ALREADY_TERMINAL` — returned for the already-terminal case only when polling is disabled for the account (with polling enabled the terminal case replays `200` + current state instead).", "originalRequest": { "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b0ecba7-b6b9-44a6-bfc2-051d442635ae", "name": "`CANCEL_TOO_EARLY` — wait out the 2-minute cooldown.", "originalRequest": { "url": { "path": [ "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Balance", "description": "Read your wallet balance.", "item": [ { "id": "f7e7adfd-b1e6-4aa5-84d2-48d427e84129", "name": "Get wallet balance", "request": { "name": "Get wallet balance", "description": {}, "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6c9976f6-b894-40dd-8981-a74f69a14463", "name": "Current balance in cents.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"balance_cents\": \"\",\n \"currency\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7773838a-509b-4b62-8456-d670b5067ed9", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f813b5e2-970a-469b-a5ae-a9d5befd1457", "name": "Key is valid but the account is not eligible (`ACCOUNT_BANNED`, `EMAIL_NOT_VERIFIED`, `ACCOUNT_NOT_ACTIVE`). Emitted by the auth layer — flat shape.", "originalRequest": { "url": { "path": [ "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Catalog", "description": "Discover available services, countries and prices.", "item": [ { "id": "ded02467-7a6a-4ce9-9851-64b120142c1c", "name": "List available services", "request": { "name": "List available services", "description": { "content": "Cached — response carries `Cache-Control: private, max-age=300`.", "type": "text/plain" }, "url": { "path": [ "catalog", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1a959e3f-9d0f-4c08-8a1b-cf33455f02ec", "name": "Service list.", "originalRequest": { "url": { "path": [ "catalog", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"code\": \"\",\n \"name\": \"\"\n },\n {\n \"code\": \"\",\n \"name\": \"\"\n }\n ],\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aff46a6b-6aa8-4882-b354-5c81e6a14580", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "catalog", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "356ea9ac-24be-4cfd-a83c-12b3348a1e0f", "name": "Key is valid but the account is not eligible (`ACCOUNT_BANNED`, `EMAIL_NOT_VERIFIED`, `ACCOUNT_NOT_ACTIVE`). Emitted by the auth layer — flat shape.", "originalRequest": { "url": { "path": [ "catalog", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e3cebcd3-68b0-47fb-92e9-3fb6398d42e3", "name": "List available countries", "request": { "name": "List available countries", "description": { "content": "Cached — response carries `Cache-Control: private, max-age=300`.", "type": "text/plain" }, "url": { "path": [ "catalog", "countries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6f92ba41-0dae-4569-90c6-6b8dc882b201", "name": "Country list.", "originalRequest": { "url": { "path": [ "catalog", "countries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"code\": \"\",\n \"name\": \"\",\n \"phone_prefix\": \"\",\n \"service_count\": \"\"\n },\n {\n \"code\": \"\",\n \"name\": \"\",\n \"phone_prefix\": \"\",\n \"service_count\": \"\"\n }\n ],\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d66e6349-27b5-4efb-a48a-efce5eb097e1", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "catalog", "countries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "764cacc1-d6ff-4b83-adfc-4f9e0fe1dc93", "name": "Key is valid but the account is not eligible (`ACCOUNT_BANNED`, `EMAIL_NOT_VERIFIED`, `ACCOUNT_NOT_ACTIVE`). Emitted by the auth layer — flat shape.", "originalRequest": { "url": { "path": [ "catalog", "countries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c28bfc91-7b0e-4a91-9fec-ef958644784c", "name": "List prices for one country", "request": { "name": "List prices for one country", "description": { "content": "Prices (in cents) and availability per service for the given country.\n\nCached — response carries `Cache-Control: private, max-age=60`.\n**Do not repeatedly query this endpoint**: cache it client-side\nand honour `Retry-After` on 429. Standard accounts receive 1,000 price\nqueries per 5 hours and 10,000 per 7 days. VIP accounts receive 5,000\nper 5 hours and 50,000 per 7 days.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "US" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1810bc99-2271-4005-998d-bdef4529ec05", "name": "Price list.", "originalRequest": { "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"service_code\": \"\",\n \"service_name\": \"\",\n \"price_cents\": \"\",\n \"available_count\": \"\"\n },\n {\n \"service_code\": \"\",\n \"service_name\": \"\",\n \"price_cents\": \"\",\n \"available_count\": \"\"\n }\n ],\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a43ab5c-729f-461e-9d25-43fcbfc5dc3c", "name": "`INVALID_REQUEST` — missing or malformed `country_code`.", "originalRequest": { "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ed35081-5f85-4ae0-a0c3-58242bd16978", "name": "Missing or invalid API key (`API_KEY_MISSING`, `API_KEY_INVALID_FORMAT`, `API_KEY_INVALID`, `API_KEY_REVOKED`). Emitted by the auth layer before the handler — flat shape, no `request_id`.", "originalRequest": { "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d90bd4b3-1348-41b8-948d-ad7c00e36383", "name": "Key is valid but the account is not eligible (`ACCOUNT_BANNED`, `EMAIL_NOT_VERIFIED`, `ACCOUNT_NOT_ACTIVE`). Emitted by the auth layer — flat shape.", "originalRequest": { "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0702a298-6dc3-4db4-965d-083ff12dd15b", "name": "`COUNTRY_NOT_FOUND`.", "originalRequest": { "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe6c2d58-65dc-4698-a14f-b1f69b09ccb4", "name": "`PRICE_RATE_LIMITED` — cache responses and retry after the returned reset time. Contact vip@dogesms.com if a verified business integration needs higher limits.", "originalRequest": { "url": { "path": [ "catalog", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ISO 3166-1 alpha-2, e.g. `US`.", "type": "text/plain" }, "key": "country_code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\"\n },\n \"request_id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.dogesms.com/v1", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" } ], "info": { "_postman_id": "0540db70-e647-4fc5-82fa-e22781f2aeb9", "name": "DogeSMS API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "DogeSMS API Postman Collection (v2026.08).\n\nSet the `apiKey` collection variable to your `sk_live_` key, then run any request.\n\nGenerated from the OpenAPI spec — do not edit by hand; download the latest from https://dogesms.com/docs.", "type": "text/markdown" }, "version": "2026.08" } }