Developer API · v1

Integrate SMS verification
with RynoSMS API

Programmatically rent numbers, receive SMS codes, and manage activations for 200+ countries with a simple, secure API.

API requestAPI v1 · JSON

GET/v1/account

curl -X GET \
  "https://rynosms.com/api/v1/third-party/account" \
  -H "X-API-Key: YOUR_API_KEY"

Secure by defaultScoped keys · encrypted transport

Developer friendlySimple and well-documented

Secure & reliableScoped keys and stable uptime

Wide coverage200+ countries and popular apps

Real-time resultsGet SMS and status instantly

GETaccount.read

Account

Retrieve your account profile, current wallet balance and plan.

Request

HTTPS

GET/api/v1/third-party/account

Code examples

curl 'https://rynosms.com/api/v1/third-party/account' -H 'Accept: application/json' -H 'X-API-Key: YOUR_API_KEY'

Response example

JSON

{
  "data": {
    "id": "acc_1a2b3c4d",
    "name": "Your account",
    "balance": "12.50",
    "account_type": "personal",
    "plan": "Pay as you go"
  }
}

Illustrative response. Returned data depends on the endpoint and your account.

Request headers

Required for every request

Header	Type	Required	Description
`X-API-Key`	string		Your API key from the dashboard.
`Accept`	string		Set to `application/json`.

LIVE API SANDBOX

Try it in your workspace

Send a real request and inspect the JSON response.

Key stays in this tab

API keyQuery parameters

Use server-side requests for production integrations. Never expose an API key in a public browser app.

Response

Your response will appear here after you send a request.

START HERE

From API key to first SMS

Connect the pieces in a few clear steps, then follow the endpoint reference above.

Create a scoped key

Generate a key with only the catalog, billing, or order permissions your integration needs.

Find a live route

Check countries, services, and current offers before choosing a number.

Place an order

Buy an eligible offer and use one unique request UUID for safe retries.

Read the SMS

Poll the activation status and read received message details from your account.

Rate limits and retries

Requests are limited to 60 per minute per key. For purchases, retain the same request UUID when retrying a request whose outcome is unknown.

Errors and supplier review

HTTP status codes describe request outcomes. A review status means supplier confirmation is still pending; check that order before creating another purchase.

BUILT FOR REAL WORKFLOWS

What you can build with the API

Check account balance

Display current balance and plan information in your own tools.

Manage usage and orders

Track activations, transactions, and order status programmatically.

Automate verification flows

Connect number selection and SMS delivery to your internal workflow.

READY WHEN YOU ARE

Get your API key and start building.

Create a scoped key, explore the routes, and integrate SMS verification into your product.

Get API key View documentation

Scoped API keys
Interactive API tester
Examples for each endpoint