# 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"
// First page
const response = await fetch('https://api.infinipost.co/v1/phones?status=ready&limit=50', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
// Next page
if (data.hasMore) {
const nextResponse = await fetch(`https://api.infinipost.co/v1/phones?status=ready&limit=50&cursor=${data.nextCursor}`, {
headers: { '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"
}
Phones
List Phones
Retrieve a list of all your cloud phones
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"
// First page
const response = await fetch('https://api.infinipost.co/v1/phones?status=ready&limit=50', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
// Next page
if (data.hasMore) {
const nextResponse = await fetch(`https://api.infinipost.co/v1/phones?status=ready&limit=50&cursor=${data.nextCursor}`, {
headers: { '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
string
Filter by phone status. One of:
ready, warming_up, or pending_setup.number
default:"50"
Number of phones to return (max 100).
string
Cursor for pagination. Pass the
nextCursor value from the previous response to get the next page. Omit for the first page.Response
array
Array of phone objects.
Show Phone object properties
Show Phone object properties
string
Unique identifier for the phone.
string
Display name of the phone.
number
The slot number assigned to this phone.
string
Current phone status:
ready, warming_up, or pending_setup.string
The plan associated with this phone.
boolean
Whether a TikTok account has been created on this phone.
boolean
Whether an Instagram account has been created on this phone.
string
ISO 8601 timestamp of when the phone was created.
string
ISO 8601 timestamp of when the phone was last updated.
boolean
Whether there are more phones beyond this page.
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"
// First page
const response = await fetch('https://api.infinipost.co/v1/phones?status=ready&limit=50', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
// Next page
if (data.hasMore) {
const nextResponse = await fetch(`https://api.infinipost.co/v1/phones?status=ready&limit=50&cursor=${data.nextCursor}`, {
headers: { '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"
}
}