JesusNumber API

The JesusNumber API allows you to programmatically order USA non-VoIP phone numbers for SMS verification. All requests require authentication via your API key.

Base URL

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

Generate and manage your API key from the Dashboard → API Keys page after you log in.

Authentication

Include your API key in every request header:

Authorization: Bearer YOUR_API_KEY

For GET endpoints documented below, you may also pass api_key=YOUR_API_KEY as a query parameter where shown.

USA Short-Term Numbers

Order a temporary USA number for single-use SMS verification.

POST /api/v1/short-term/order/

Order a number

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 /api/v1/short-term/sms/?order_id=ORD-123456&api_key=YOUR_API_KEY

Get SMS

Response

{
  "success": true,
  "code": "482910",
  "message": "<#> 482910 is your code. Don't share it.",
  "received_at": "2026-05-22T14:30:00Z"
}

POST /api/v1/short-term/cancel/

Cancel order

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 /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 /api/v1/rental/30day/list/?api_key=YOUR_API_KEY

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 /api/v1/rental/30day/sms/?rental_id=RNT-789012&api_key=YOUR_API_KEY

Get SMS for rental

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 /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 /api/v1/rental/1day/sms/?rental_id=RNT-1D-345678&api_key=YOUR_API_KEY

Get SMS for 1-day rental

Response

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

Error Codes

Code	Meaning	Fix
400	Bad Request	Check your request parameters
401	Unauthorized	Invalid or missing API key
402	Insufficient Balance	Add funds to your account
404	Not Found	Order/rental ID does not exist
429	Rate Limited	Too many requests, slow down
500	Server Error	Contact support