DEVELOPER API

Disposable Phone Number API

Throwaway numbers for one-time verification — provision, verify, discard, all over API.

The Disposable Phone Number API gives you temporary, single-use numbers for SMS verification that expire automatically. No SIMs, no recycling logic on your side — request a number, capture the code, and let it lapse. Ideal for privacy-preserving sign-ups and automated testing.

How it works

Request a disposable number

One POST returns a fresh number scoped to your target service and country.

Capture the code

Read the inbound verification code over REST or webhook.

Auto-expire

The number lapses after the session — no cleanup, no lingering cost.

Code examples

Provision a disposable number and read its code.

# 1 — request a number for the service
curl -X POST "https://api.eveses.com/v1/numbers/orders" \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"any-disposable","country":"us"}'
# → { "id":"act_9f2", "number":"+1202555••••", "status":"waiting" }

# 2 — poll for the code (or use a webhook)
curl "https://api.eveses.com/v1/numbers/orders/act_9f2" \
  -H "Authorization: Bearer $EVESES_API_KEY"
# → { "id":"act_9f2", "status":"received", "code":"483920" }

Pricing

Cheapest per-code option; you pay only for numbers that receive a message. Everything runs from your wallet.

See full pricing →

Integrations

ZapierMaken8nPostmanWebhooksRESTOpenAPI

Fire webhooks into Zapier, Make or n8n, or call the REST API directly.

Official SDKs

JavaScript / TypeScript ↗Python ↗Go ↗PHP ↗

OpenAPI & Postman

Import the OpenAPI spec or the Postman collection to generate a typed client in any language.

Open the spec →

FAQ

What is a disposable phone number?›

A temporary number used once — typically to receive a single verification SMS — that is discarded afterward. It keeps your real number private and is provisioned entirely via API.

How long does a disposable number last?›

For the length of the activation window (minutes). If no message arrives it expires free; you never manage teardown yourself.

Can I get a new number each time?›

Yes — every activation returns a fresh number, which is the point of a disposable line.