📘 Developer docs

Get your first SMS in 90 seconds

REST API, 4 typed SDKs, signed webhooks, idempotency keys, single-tenant pools on Enterprise. Full reference + working code in your language.

Quickstart

Three calls and you're done

  1. 1
    Buy a number

    Pick country + service. We assign a real phone number from the cheapest healthy upstream pool.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders \
      -H "Authorization: Bearer $KEY" \
      -d '{"country":"ua","mode":"activation","service":"telegram"}'
    
    # → 201 Created · 142ms
    # { "order_id":"ord_91f3a2b8", "phone":"+380635551822", "status":"waiting", "price_cents":7 }
  2. 2
    Wait for SMS · poll or webhook

    Either subscribe to activation.sms_received webhook or poll. p95 SMS arrival is 2.1 seconds.

    curl https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/sms \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 87ms
    # { "status":"sms_received", "sms":[{ "otp":"123456", "received_at":"..." }] }
  3. 3
    Finish — funds get charged

    Until you call finish, funds stay held, not spent. Cancel any time within the window for a full refund.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/finish \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 61ms
    # { "status":"finished", "charged_cents":7 }

Browse the docs

Searchable, with examples in 4 languages, and live Try-it sandbox in every endpoint.

📦 Typed SDKs

4 languages · all generated from the same OpenAPI spec · auto-retried · typed errors.

JS@eveses/sdkPYEvesesGOevesescom/go-sdkPHPeveses/sdk
RBeveses-rb (soon)
RSeveses-rs (soon)
JVeveses-java (soon)

Ready to ship?

First activation on us · no card required · refund if no SMS.

⚡ Sign up — start building
STAY IN THE LOOP

New geos, new pools, new endpoints.

We add countries, rotate pools and ship API changes most weeks. Drop your email and we'll send the ones worth knowing about — new geo coverage, price-ladder changes and anything that breaks an integration.

✓ New geos & products⚡ Breaking API changes🫥 No spam, ever

Unsubscribe with one click. We never share your email.