Quick Start
Base URL
https://app.otpgrove.com
Example request (curl)
curl -X GET "https://app.otpgrove.com/orders/api/v1/services/temporary/" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Temp-Number USA
GET /orders/api/v1/services/temporary/
List available USA temporary services (and pricing/state options if applicable).
POST /orders/api/v1/order/temporary/
Request body
{
"service_id": 123,
"area_code": "212"
}
Response
{
"success": true,
"data": {
"order_id": 1001,
"status": "pending",
"phone": "+1XXXXXXXXXX",
"expires_in_seconds": 1200
}
}
Best-Temp Number USA
GET /orders/api/v1/services/best-temp/
Curated “best route” temporary services for stricter verifications.
POST /orders/api/v1/order/best-temp/
Request body
{
"service_id": 123
}
Response
{
"success": true,
"data": {
"order_id": 1002,
"status": "pending",
"phone": "+1XXXXXXXXXX"
}
}
Rent-Number USA (1-Day)
GET /orders/api/v1/services/rent-1day/
POST /orders/api/v1/order/rent-1day/
Request body
{
"service_id": 123
}
Response
{
"success": true,
"data": {
"order_id": 2001,
"status": "active",
"phone": "+1XXXXXXXXXX",
"rental_days": 1
}
}
Rent-Number USA (30-Days)
GET /orders/api/v1/services/rent-30days/
POST /orders/api/v1/order/rent-30days/
Request body
{
"service_id": 123
}
Response
{
"success": true,
"data": {
"order_id": 3001,
"status": "active",
"phone": "+1XXXXXXXXXX",
"rental_days": 30
}
}
Long-Term Providers
Use this catalog to discover provider-backed long-term routes and create corresponding orders.
GET /orders/api/v1/services/long-term-providers/
POST /orders/api/v1/order/long-term-provider/
Request body
{
"service_id": 123,
"provider_code": "provider_a",
"days": 90
}
Response
{
"success": true,
"data": {
"order_id": 4001,
"status": "active",
"phone": "+1XXXXXXXXXX",
"provider_code": "provider_a",
"rental_days": 90
}
}
Global Numbers
GET /orders/api/v1/services/global/?country_id=12
POST /orders/api/v1/order/global/
Request body
{
"service_id": 123,
"country_id": 12
}
Response
{
"success": true,
"data": {
"order_id": 5001,
"status": "pending",
"phone": "+XXXXXXXXXXX",
"country_id": 12
}
}