DEVELOPER API

Virtual number API for real SMS verification.

Connect your platform to RynoSMS. Check your balance, discover live number offers, buy an activation and retrieve its SMS code through one REST API.

Get API access →View documentation

REST + JSONScoped credentialsSafe retriesServer-side access

⌘ API PlaygroundREST / JSON

♙

Scoped API keyKeep credentials private

✓

THE RYNOSMS ADVANTAGE

One API for the number lifecycle.

Use the same wallet and live supplier inventory as the RynoSMS dashboard. Every offer includes its payable USD price, available stock and route ID.

Live number inventory

Browse purchasable services, countries, operators and payable prices.

◇

Scoped integration keys

Grant balance, catalogue, order or billing access as needed.

▱

Complete activation flow

Purchase, poll for SMS and request supplier-confirmed cancellation.

⌘

Automation-ready flow

Connect catalogue, purchase, and status checks from your server.

INTEGRATION PATH

Your first virtual number in four steps.

Create a scoped key, inspect live offers, submit an idempotent purchase and poll the activation until an SMS code arrives.

Open API reference →

01⌘

Create a scoped key

Name your integration and grant only the access it needs.

02▤

Make your first call

Request the account endpoint from your backend.

03↗

Order and poll

Choose a live offer, buy with an idempotency UUID and poll for the SMS code.

04↻

Poll for the SMS

Check the activation status until a message or final result arrives.

◇

▣

⌑

SECURITY & ACCESS

Keep access scoped and server-side.

Pass a scoped key as X-API-Key or a Bearer token over HTTPS. Never expose it in browser code or a public repository.

◇Your key, your scopesCreate up to five active keys. Grant only the access needed; revoke keys in your dashboard.

▱Server-side by defaultKeep keys in a secret manager. Browser code can expose them, even when the UI masks them.

API Token

••••••••••••••

Scopesaccount.readcatalog.readorders.writeorders.readManage credentials →

API CAPABILITIES

Find numbers ready to purchase.

Filter live offers by service or country. Prices and stock can change, so use the returned offer ID and check the purchase response before confirming an order.

▣

Account and balance

Read account profile and balance.

◎

Countries and services

List enabled countries with optional filters. List enabled services and platforms.

Live activation offers

Get route IDs, operators, stock and payable USD prices.

↗

Purchase a number

Buy a number using an offer ID and idempotency UUID.

▤

Read SMS status

Read a number, SMS text and verification code.

◇

Billing history

Read paginated top-up history. Read paginated balance entries.

ENDPOINT EXPLORER

Live SMS activation endpoints.

Browse purchasable routes, create activations, read SMS status and cancel eligible orders. Every endpoint lists its method and required key scope.

Open full documentation →

BASE URLhttps://rynosms.com/api/v1/third-party

GET/accountv2

Read account profile and balance.

RequestResponsecURL

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

REQUEST EXAMPLES

Use familiar tools to connect

Start from the documented HTTP examples and adapt them to your server-side stack.

⌘ cURLJS Node.jsPHPPy PythonGoJava

RELIABILITY & DELIVERY

Predictable errors and safe retries.

Handle validation, authentication and rate-limit responses explicitly. Reuse the same UUID when retrying a purchase; do not create a second order after an uncertain result.

↗AccessCheck the key, its active state and required scope.

↻ValidationReview query parameters before retrying.

♧Rate limitsUse the Retry-After header when limited and poll SMS status about every five seconds.

? Developer FAQ

Frequently asked questions

Clear answers about API access, requests, credentials, and building with RynoSMS.

Balance, live activation countries, services and offers, number purchases, activation status, cancellation, top-ups and transactions are available.

Browse API documentation

Build with RynoSMS

Start your SMS API integration.

Create a scoped key, inspect a live offer and test the activation flow in the interactive reference.

Create API access Browse documentation

Scoped API access
Clear request limits
Live SMS status updates