NonVoIPService API Documentation

Integrate NonVoIPService number services into your applications using a REST API. The same account key covers the number products documented here, including USA short-term, USA long-term, and worldwide numbers. Public rates stay on pricing; delivery limits are explained in the FAQ.

Introduction

The NonVoIPService API lets you request numbers across every supported product category, check order status, and list available services or countries.

API base URL

https://nonvoipservice.com/api/v1
  • All requests use HTTPS in production.
  • Request and response bodies use JSON.
  • Successful responses use {"success": true, "data": {...}}.
  • Errors use {"success": false, "error": {"code": "...", "message": "..."}}.

Authentication

ONE API KEY

One API key. All number products. Use your NonVoIPService account API key across every supported number service — USA Short-Term, USA Long-Term, and Worldwide. Do not create separate credentials for each product.

Authenticate every request with the Bearer scheme:

Authorization: Bearer YOUR_API_KEY

Example:

curl https://nonvoipservice.com/api/v1/usa/short-term/network-one/services \
  -H "Authorization: Bearer YOUR_API_KEY"

The same API key authenticates requests to Short-Term, Long-Term, and Worldwide endpoints. The request path and body select the number product.

API Keys

  1. Log in to NonVoIPService.
  2. Open Dashboard → API.
  3. Create your single account API key.
  4. Copy and securely store the key — it is shown only once.
  • You have one API key per account.
  • Keys are private credentials. Do not commit them to Git.
  • Do not expose keys in browser-side JavaScript.
  • Regenerate immediately if a key may be compromised.

Manage your key at https://nonvoipservice.com/dashboard/api/.

USA Short-Term

These products use your same NonVoIPService API key. Choose the endpoint that matches the number product you need.

USA Short-Term — Network One

USA short-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/short-term/network-one/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/short-term/network-one/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/short-term/network-one/services 
curl https://nonvoipservice.com/api/v1/usa/short-term/network-one/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

USA Short-Term — Network Two

USA short-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/short-term/network-two/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/short-term/network-two/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/short-term/network-two/services 
curl https://nonvoipservice.com/api/v1/usa/short-term/network-two/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

USA Short-Term — Network Three

USA short-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/short-term/network-three/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/short-term/network-three/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/short-term/network-three/services 
curl https://nonvoipservice.com/api/v1/usa/short-term/network-three/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

USA Long-Term

These products use your same NonVoIPService API key. Choose the endpoint that matches the number product you need.

Long Term Number USA — 1 Day

USA long-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/long-term/1-day/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/long-term/1-day/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/long-term/1-day/services 
curl https://nonvoipservice.com/api/v1/usa/long-term/1-day/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Long Term Number USA — 3 Days

USA long-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/long-term/3-days/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/long-term/3-days/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/long-term/3-days/services 
curl https://nonvoipservice.com/api/v1/usa/long-term/3-days/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Long Term Number USA — 7 Days

USA long-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/long-term/7-days/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/long-term/7-days/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/long-term/7-days/services 
curl https://nonvoipservice.com/api/v1/usa/long-term/7-days/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Long Term Number USA — 14 Days

USA long-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/long-term/14-days/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/long-term/14-days/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/long-term/14-days/services 
curl https://nonvoipservice.com/api/v1/usa/long-term/14-days/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Long Term Number USA — 30 Days

USA long-term number ordering through the NonVoIPService API.

Get Number

POST /api/v1/usa/long-term/30-days/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "service": "example_service"
}

service — service name or service code available for this product.

curl -X POST https://nonvoipservice.com/api/v1/usa/long-term/30-days/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/usa/long-term/30-days/services 
curl https://nonvoipservice.com/api/v1/usa/long-term/30-days/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Worldwide

These products use your same NonVoIPService API key. Choose the endpoint that matches the number product you need.

Global Short Term Number

Worldwide number ordering through the NonVoIPService API.

Get Number

POST /api/v1/global/short-term/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "country": "44",
  "service": "example_service"
}

country — country code from the countries endpoint. service — service name or code for that country.

curl -X POST https://nonvoipservice.com/api/v1/global/short-term/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"44","service":"example_service"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/global/short-term/services 
curl "https://nonvoipservice.com/api/v1/global/short-term/services?country=44" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Countries

GET /api/v1/global/short-term/countries 
curl https://nonvoipservice.com/api/v1/global/short-term/countries \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INVALID_COUNTRY, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Global Long Term Number

Worldwide number ordering through the NonVoIPService API.

Get Number

POST /api/v1/global/long-term/get-number

Authentication: Bearer YOUR_API_KEY (same account key for all products).

Request body

{
  "country": "44",
  "service": "example_service",
  "duration": "7_days"
}

country — country code from the countries endpoint. service — service name or code. duration — one of 1_day, 3_days, 7_days, 14_days.

curl -X POST https://nonvoipservice.com/api/v1/global/long-term/get-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"44","service":"example_service","duration":"7_days"}'

Example response

{
  "success": true,
  "data": {
    "order_id": "NVS-10245",
    "phone_number": "+1XXXXXXXXXX",
    "service": "example_service",
    "country": "US",
    "status": "waiting",
    "status_label": "Waiting for SMS",
    "otp": null,
    "created_at": "2026-09-27T12:00:00+00:00",
    "expires_at": "2026-09-27T12:20:00+00:00"
  }
}

List Services

GET /api/v1/global/long-term/services 
curl "https://nonvoipservice.com/api/v1/global/long-term/services?country=44&duration=7_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Countries

GET /api/v1/global/long-term/countries 
curl https://nonvoipservice.com/api/v1/global/long-term/countries \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible errors: INVALID_API_KEY, API_KEY_REVOKED, INVALID_SERVICE, INVALID_COUNTRY, INSUFFICIENT_BALANCE, NUMBER_UNAVAILABLE, SERVICE_UNAVAILABLE, REQUEST_FAILED, RATE_LIMIT_EXCEEDED.

Orders

Check the status of an API-created order. Orders appear in your NonVoIPService dashboard history as well.

GET /api/v1/orders/{order_id} 
curl https://nonvoipservice.com/api/v1/orders/NVS-10245 \
  -H "Authorization: Bearer YOUR_API_KEY"

The API key must belong to the same network category that created the order.

Errors

All errors use a consistent NonVoIPService format:

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient NonVoIPService balance."
  }
}
  • INVALID_API_KEY — missing or invalid key
  • API_KEY_REVOKED — key was revoked or regenerated
  • INSUFFICIENT_BALANCE — wallet balance too low
  • INVALID_SERVICE — unknown or unavailable service
  • INVALID_COUNTRY — missing or invalid country for worldwide endpoints
  • NUMBER_UNAVAILABLE — no number currently available
  • SERVICE_UNAVAILABLE — temporary service issue
  • REQUEST_FAILED — request could not be completed
  • ORDER_NOT_FOUND — order does not exist for this key
  • INVALID_REQUEST — malformed or unauthorized request
  • RATE_LIMIT_EXCEEDED — too many requests
  • INTERNAL_ERROR — unexpected server error

Rate Limits

API keys are limited to 60 requests per minute. If the limit is exceeded, the API returns RATE_LIMIT_EXCEEDED.

API Security

  • Keep API keys private and rotate them if exposed.
  • Always use HTTPS.
  • Do not embed keys in frontend JavaScript or mobile apps.
  • Store keys in server-side environment variables.
  • Use separate keys per environment when practical.
  • Revoke unused keys from Dashboard → API.

Examples

USA Short-Term — Network One

curl -X POST https://nonvoipservice.com/api/v1/usa/short-term/network-one/get-number \
  -H "Authorization: Bearer nvs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram"}'

USA Long-Term — 7 Days

curl -X POST https://nonvoipservice.com/api/v1/usa/long-term/7-days/get-number \
  -H "Authorization: Bearer nvs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram"}'

Global Short-Term

curl -X POST https://nonvoipservice.com/api/v1/global/short-term/get-number \
  -H "Authorization: Bearer nvs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"GB","service":"telegram"}'

Use a country value from GET /global/short-term/countries (country_code or country name).

Global Long-Term

curl -X POST https://nonvoipservice.com/api/v1/global/long-term/get-number \
  -H "Authorization: Bearer nvs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"GB","service":"telegram","duration":"7_days"}'

Poll order status

curl https://nonvoipservice.com/api/v1/orders/NVS-10245 \
  -H "Authorization: Bearer nvs_live_YOUR_KEY"