Developer API

JesusNumber API

Order USA non-VoIP phone numbers, receive SMS verification codes, and manage rentals programmatically with your account API key.

API is live — all /api/v1/ endpoints below are active on production. Use the exact base URL and include your API key on every request.

All public endpoints live under https://jesusnumber.com/api/v1/. Use the exact base URL and include your API key on every request.

Base URL (copy this)

https://jesusnumber.com/api/v1/
  • Use paths exactly as documented — include the trailing slash (e.g. .../order/).
  • Do not use /api/orders/ — that is the logged-in dashboard API, not the public API.
  • Get your key from Dashboard → API Keys after you log in.

Quick Start

Verify your setup in under a minute before building your integration.

  1. Get your API key from Dashboard → API Keys.
  2. Test connectivity — a 401 without a key means the route exists; 404 means the URL path is wrong.
  3. Order → poll SMS — place a short-term order, then poll the SMS endpoint every 3–5 seconds.

Test your API key (balance check)

curl -sS "https://jesusnumber.com/api/v1/balance/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Expected success response

{
  "success": true,
  "message": "Wallet balance retrieved.",
  "data": {
    "balance": 50.00,
    "hold_balance": 0.0,
    "spend_balance": 0.0,
    "deposit": 0.0
  }
}

Authentication

Send your API key on every request using one of these methods:

Recommended

Bearer header

Authorization: Bearer YOUR_API_KEY

X-API-Key header

X-API-Key: YOUR_API_KEY

Query param (GET only)

?api_key=YOUR_API_KEY

JSON body field (POST)

{ "api_key": "YOUR_API_KEY", ... }

POST requests should use Content-Type: application/json unless noted otherwise.

Balance & Products

Check your wallet and browse available services before placing orders.

GET https://jesusnumber.com/api/v1/balance/

Get account balance

Returns your available wallet balance for API orders.

GET https://jesusnumber.com/api/v1/products/

List products

Optional query filters: category, search (e.g. ?search=instagram).

Response excerpt

{
  "success": true,
  "data": {
    "count": 12,
    "products": [
      {
        "name": "instagram",
        "category": "short_term",
        "price": 0.42
      }
    ]
  }
}

USA Short-Term Numbers

Order a temporary USA number for single-use SMS verification. Use the platform name from /products/ as the service value (case-insensitive).

POST https://jesusnumber.com/api/v1/short-term/order/

Order a number

Example request

curl -sS -X POST "https://jesusnumber.com/api/v1/short-term/order/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service": "instagram"}'

Request body (JSON)

{
  "service": "instagram",
  "api_key": "YOUR_API_KEY"
}

Response

{
  "success": true,
  "number": "12025550147",
  "order_id": "ORD-123456",
  "price": 0.42,
  "expires_in": "20 minutes"
}
GET https://jesusnumber.com/api/v1/short-term/sms/?order_id=ORD-123456

Get SMS

Poll every 3–5 seconds until code is returned. Accepts ORD-123, numeric ID, or provider external ID.

Response

{
  "success": true,
  "code": "482910",
  "message": "<#> 482910 is your code. Don't share it.",
  "received_at": "2026-05-22T14:30:00Z"
}
POST https://jesusnumber.com/api/v1/short-term/cancel/

Cancel order

Cancel before an SMS code arrives to receive a refund.

Request body (JSON)

{
  "order_id": "ORD-123456",
  "api_key": "YOUR_API_KEY"
}

Response

{
  "success": true,
  "refunded": 0.42
}

USA Long-Term 30-Day Rental

Rent a dedicated USA number for 30 days.

POST https://jesusnumber.com/api/v1/rental/30day/order/

Order rental

Request body (JSON)

{
  "service": "whatsapp",
  "api_key": "YOUR_API_KEY"
}

Response

{
  "success": true,
  "number": "13105550198",
  "rental_id": "RNT-789012",
  "price": 19.99,
  "expires_at": "2026-06-22T00:00:00Z"
}
GET https://jesusnumber.com/api/v1/rental/30day/list/

List active rentals

Response

{
  "success": true,
  "rentals": [
    {
      "rental_id": "RNT-789012",
      "number": "13105550198",
      "service": "whatsapp",
      "expires_at": "2026-06-22T00:00:00Z",
      "status": "active"
    }
  ]
}
GET https://jesusnumber.com/api/v1/rental/30day/sms/?rental_id=RNT-789012

Get SMS for rental

Auto-activates the number for the SMS window when needed.

Response

{
  "success": true,
  "messages": [
    {
      "code": "739551",
      "message": "Your WhatsApp code: 739551",
      "received_at": "2026-05-22T15:00:00Z"
    }
  ]
}

USA Long-Term 1-Day Rental

Rent a dedicated USA number for 24 hours.

POST https://jesusnumber.com/api/v1/rental/1day/order/

Order 1-day rental

Request body (JSON)

{
  "service": "telegram",
  "api_key": "YOUR_API_KEY"
}

Response

{
  "success": true,
  "number": "17325550164",
  "rental_id": "RNT-1D-345678",
  "price": 3.65,
  "expires_at": "2026-05-23T14:30:00Z"
}
GET https://jesusnumber.com/api/v1/rental/1day/sms/?rental_id=RNT-1D-345678

Get SMS for 1-day rental

Auto-activates the number for the SMS window when needed.

Response

{
  "success": true,
  "messages": [
    {
      "code": "104882",
      "message": "104882 is your Telegram code.",
      "received_at": "2026-05-22T16:00:00Z"
    }
  ]
}

Troubleshooting

Symptom Likely cause Fix
404 on every endpoint Wrong base path or missing trailing slash Use https://jesusnumber.com/api/v1/ exactly — e.g. .../short-term/order/ not .../short-term/order
404 on order/SMS only Order or rental ID not found Use the order_id / rental_id from your order response
401 Unauthorized Missing or invalid API key Copy key from API Keys; try Authorization: Bearer ...
402 Insufficient balance Wallet too low Add funds via dashboard deposit before ordering
HTML page instead of JSON Hitting dashboard routes or wrong host Public API is only under /api/v1/, not /api/orders/

Need help? Email support@jesusempire.com or Telegram @JesusNumberSupport with the full URL, status code, and response body (redact your API key).

Error Codes

Code Meaning Fix
400Bad RequestCheck your request parameters
401UnauthorizedInvalid or missing API key
402Insufficient BalanceAdd funds to your account
404Not FoundWrong URL path, missing trailing slash, or order/rental ID does not exist
429Rate LimitedToo many requests, slow down
500Server ErrorContact support