Wiring +993 Turkmenistan verification into your OTP pipeline

Which API calls return a Turkmenistan verification number?

Start with the endpoints, since they define everything else. Authenticate against https://otproute.com/api/v1 with a Bearer key from the Developer console; keys carry the or_live_ prefix and each account may hold up to 10. The country id for Turkmenistan is tm.

1. GET /api/v1/services and GET /api/v1/countries give you the catalogue. Cache them, but refresh daily.
2. GET /api/v1/prices?country=tm&service=<id> reports the current price and whether the route is open for that service.
3. POST /api/v1/activations with {"service": "imo", "country": "tm"} reserves a +993 number and returns an activation id.
4. GET /api/v1/activations/{id} returns the +993 order's state, plus the code after the SMS lands.
5. POST /api/v1/activations/{id}/cancel releases an order your test no longer needs.
6. GET /api/v1/balance lets a pipeline stop early when funds run low.

The account limit is 300 requests per minute, shared by all keys. The API reference documents request and response shapes.

Should a +993 test listen for webhooks or poll?

Polling is fine for a single developer clicking through a flow. Once several jobs run at once, webhooks are cheaper and quicker to react. An account can hold 5 webhook endpoints; point one at your Turkmenistan test runner for activation.sms_received, activation.expired and activation.cancelled.

Treat every delivery as untrusted until proven otherwise. Split the X-OTPRoute-Signature header into t and v1, calculate HMAC-SHA256 over t, a period and the exact raw body with your endpoint secret, and compare in constant time. Reject timestamps outside a short tolerance to block replays. Store results keyed on the activation id so a retried delivery changes nothing. Our post on webhook-based OTP capture shows a queue-backed handler, and CI pipeline testing covers timeouts in build jobs.

What can be verified on a Turkmenistan verification number?

The tm route lists more than 1,600 services. Among the commonly requested ones right now are imo, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), Viber, WeChat, Discord and Snapchat. Messaging apps carry much of the everyday traffic in Central Asia, which is why they feature so heavily.

This is a snapshot, not a contract. Capacity from our carrier partners shifts across the day, so query prices before each run rather than assuming yesterday's list still holds.

How are +993 numbers formatted and localised?

Turkmenistan's national significant number has eight digits, and most mobile ranges begin with 6. Domestically people dial an 8 trunk prefix in front; internationally that prefix is dropped and the number becomes +993 followed by the eight digits.

• Normalise to E.164 (+9936XXXXXXX) at the edge of your system and store only that.
• Don't reuse validation written for neighbouring countries; lengths and prefixes differ across Central Asia.
• Turkmen is the official language and is written in a Latin alphabet with letters such as ä, ç, ň, ö, ş, ü, ý and ž. Russian is still widely understood. A verification SMS may therefore arrive in Turkmen, Russian or English, and your extractor should read digits out of any UTF-8 body.

Teams usually test here when a Central Asian rollout is planned, when a Turkmen or Russian interface needs localisation QA, or when they serve customers who travel between Ashgabat and neighbouring markets.

Can someone order a +993 code without writing code?

Yes. After you sign up with an email code or Google and fund the wallet, open the OTP Gateway, choose a service, select Turkmenistan, and confirm the price displayed. The +993 number appears immediately; enter it where the app asks, request the SMS, and watch the activation card for the code. The number serves that one verification only.

Why might a Turkmenistan code fail to land?

• The service refuses virtual numbers. Some do. That is a policy on their side, and the refund rule exists for precisely this case.
• The route is busy. Try again later or with a new activation, which uses a different number.
• The window was cut short. Leave the activation open the full 20 minutes; an expired order is refunded automatically.
• The retry loop is too aggressive. Back off between attempts instead of placing orders back to back.

These steps keep the OTP routing healthy for everyone sharing the pool.

Is there a long-term Turkmen line, and how does billing work?

No self-serve Dedicated Number exists for Turkmenistan. OTP Route sells long-term lines only in the United States and Canada, from $1.95/month; requests for other countries can go to [email protected], with no promise that local rules allow it.

Everything else runs from one prepaid USD wallet with no monthly fee. Pay by card or USDT/USDC, receive a PDF invoice per top-up, and ask for sandbox mode on a development account to test the SMS verification API with simulated numbers. Use it only for your own legitimate products and accounts, within each service's terms and our Acceptable Use Policy.

Frequently asked questions

Can I get a +993 number for testing my app's registration?

Yes. Create an activation for the tm country id and your chosen service, then use the returned number in your own sign-up flow.

What does a Turkmenistan verification code cost on OTP Route?

From $0.20 per code. The live price per service comes from the prices endpoint and is also shown in the dashboard.

Do I need to include the 8 prefix when entering a Turkmen number?

No. The 8 is only for domestic dialing, so use +993 and the eight-digit national number.

How do I know a webhook about a +993 code really came from OTP Route?

Verify the HMAC-SHA256 signature in the X-OTPRoute-Signature header against the raw body and reject old timestamps.

Is a refund automatic when no SMS reaches the Turkmenistan number?

Yes. When the 20-minute window expires or you cancel, the full charge returns to your wallet.

Can I keep a Turkmenistan number for repeat logins?

Not through self-serve. Long-term numbers are offered only for the US and Canada; email support if you have a special requirement.

In which language will Turkmen OTP messages arrive?

That depends on the app; Turkmen, Russian and English are all possible, so parse digits rather than words.

Service names are trademarks of their respective owners. OTP Route is not affiliated with them. Use numbers lawfully, follow each service's terms and our Acceptable Use Policy.