Skip to main content
GET
/
v1
/
phones
# First page
curl "https://api.infinipost.co/v1/phones?status=ready&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Next page (using cursor from previous response)
curl "https://api.infinipost.co/v1/phones?status=ready&limit=50&cursor=cGhvbmVfYWJjMTIz" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "phoneId": "phone_abc123",
      "profileName": "Premium Phone 1",
      "phoneSlot": 1,
      "status": "ready",
      "plan": "Premium",
      "tiktokConnected": true,
      "instagramConnected": false,
      "createdAt": "2024-04-21T20:00:00Z",
      "updatedAt": "2024-04-22T10:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cGhvbmVfYWJjMTIz"
}

​
Query Parameters

​
status
string
Filter by phone status. One of: ready, warming_up, or pending_setup.
​
limit
number
default:"50"
Number of phones to return (max 100).
​
cursor
string
Cursor for pagination. Pass the nextCursor value from the previous response to get the next page. Omit for the first page.

​
Response

​
data
array
Array of phone objects.
​
hasMore
boolean
Whether there are more phones beyond this page.
​
nextCursor
string
Cursor to pass as the cursor query parameter to retrieve the next page. null when there are no more pages.
# First page
curl "https://api.infinipost.co/v1/phones?status=ready&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Next page (using cursor from previous response)
curl "https://api.infinipost.co/v1/phones?status=ready&limit=50&cursor=cGhvbmVfYWJjMTIz" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "phoneId": "phone_abc123",
      "profileName": "Premium Phone 1",
      "phoneSlot": 1,
      "status": "ready",
      "plan": "Premium",
      "tiktokConnected": true,
      "instagramConnected": false,
      "createdAt": "2024-04-21T20:00:00Z",
      "updatedAt": "2024-04-22T10:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cGhvbmVfYWJjMTIz"
}

​
Error Responses

Unauthorized
{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}
Invalid Status
{
  "error": {
    "code": "invalid_parameter",
    "message": "status must be one of: ready, warming_up, pending_setup"
  }
}
Invalid Cursor
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid cursor"
  }
}
Server Error
{
  "error": {
    "code": "internal",
    "message": "An unexpected error occurred"
  }
}