Skip to main content
GET
/
v1
/
partners
/
accounts
curl -X GET 'https://api.infinipost.co/v1/partners/accounts?partnerUserId=user_abc123' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "accounts": [
    {
      "accountId": "acc_9n2x7yp0dg",
      "name": "Fashion Creator",
      "username": "fashioncreator22",
      "status": "ready",
      "phoneId": "abc123",
      "stripeSubscriptionId": "sub_1234567890",
      "createdAt": "2024-04-21T19:30:00Z"
    },
    {
      "accountId": "acc_4qxstggdbuh",
      "name": "Style Insider",
      "username": null,
      "status": "pending_creation",
      "phoneId": "def456",
      "stripeSubscriptionId": "sub_0987654321",
      "createdAt": "2024-04-21T19:30:00Z"
    }
  ]
}

​
Query Parameters

​
partnerUserId
string
required
Your internal user ID for the customer. Must match the partnerUserId used when creating the checkout session.

​
Response

​
accounts
array
Array of account objects for the specified user.
curl -X GET 'https://api.infinipost.co/v1/partners/accounts?partnerUserId=user_abc123' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "accounts": [
    {
      "accountId": "acc_9n2x7yp0dg",
      "name": "Fashion Creator",
      "username": "fashioncreator22",
      "status": "ready",
      "phoneId": "abc123",
      "stripeSubscriptionId": "sub_1234567890",
      "createdAt": "2024-04-21T19:30:00Z"
    },
    {
      "accountId": "acc_4qxstggdbuh",
      "name": "Style Insider",
      "username": null,
      "status": "pending_creation",
      "phoneId": "def456",
      "stripeSubscriptionId": "sub_0987654321",
      "createdAt": "2024-04-21T19:30:00Z"
    }
  ]
}

​
Account Statuses

StatusDescription
pending_creationPhone is provisioned, TikTok account is being set up
warming_upAccount is created and going through the 7-day warmup period
readyAccount is fully warmed up and ready for content posting
cancelledAccount subscription has been cancelled
Username availability: TikTok usernames are only set after Day 5 of the warmup period. Before then, the username field will be null.

​
Error Responses

Invalid API Key
{
  "error": "This API key does not have partner access"
}
Missing Required Fields
{
  "error": "partnerUserId is required"
}