# List accounts

Returns accounts, one page at a time.

```http
GET https://api.pozy.ai/v1/accounts
```

- Area: Accounts & connections / Accounts
- Auth: Authorization: Bearer pz_live_...

## Query parameters

- `profileId` (string)
- `platform` (string)
- `status` (string): one of connected, disconnected
- `search` (string)
- `category` (string): one of social, ads, communication, blogs, crm, analytics
- `sort` (string): one of account, platform, profile, status, connected
- `order` (string): one of asc, desc
- `includeOverLimit` (boolean)
- `excludeHidden` (boolean)
- `adAccountRows` (boolean)
- `includeCreatorAccounts` (boolean)
- `includeSandbox` (boolean)
- `includeStatusCounts` (boolean)
- `page` (integer)
- `limit` (integer)
- `cursor` (string)
- `profileIds` (string)
- `perProfile` (integer)

## Example request

```bash
curl -X GET "https://api.pozy.ai/v1/accounts?limit=1" \
  -H "Authorization: Bearer $POZY_API_KEY"
```

```ts
const res = await fetch("https://api.pozy.ai/v1/accounts?limit=1", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/accounts",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "limit": 1,
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `accounts`, array of object, required
  - `_id`, string, required
  - `platform`, string, required: One of `tiktok`, `instagram`, `facebook`, `youtube`, `linkedin`, `twitter`, `threads`, `pinterest`, `reddit`, `bluesky`, `googlebusiness`, `telegram`, `snapchat`, `discord`, `slack`, `whatsapp`, `shopify`, `wordpress`, `wix`, `linkedinads`, `metaads`, `pinterestads`, `tiktokads`, `xads` and 15 more
  - `profileId`, string or object, required
    - one of: string
    - one of: Profile
      - `_id`, string
      - `userId`, string
      - `name`, string
      - `description`, string
      - `color`, string
      - `timezone`, string: Can be null
      - `externalId`, string: Can be null
      - `isDefault`, boolean
      - `isOverLimit`, boolean
      - `accountCount`, integer
      - `createdAt`, string (date-time)
  - `username`, string
  - `displayName`, string
  - `platformUserId`, string
  - `scopeAreas`, array of string: Can be null
  - `oauthAppId`, string: Can be null
  - `tiktokAccountType`, string: One of `business`, `personal`, `unknown`
  - `profilePicture`, string: Can be null
  - `profileUrl`, string
  - `isActive`, boolean, required
  - `needsReconnection`, boolean
  - `followersCount`, number
  - `followersLastUpdated`, string (date-time)
  - `parentAccountId`, string: Can be null
  - `enabled`, boolean
  - `rateLimitedUntil`, string (date-time): Can be null
  - `metadata`, object
- `hasAnalyticsAccess`, boolean, required
- `pagination`, object
  - one of: Pagination
    - `page`, integer
    - `limit`, integer
    - `total`, integer
    - `pages`, integer
  - one of: Account Cursor Pagination
    - `limit`, integer, required
    - `nextCursor`, string, required: Can be null
- `profileTotals`, map of integer
- `statusCounts`, object
  - `all`, integer, required
  - `disconnected`, integer, required

```json
{
  "accounts": [
    {
      "_id": "635d87e261ae344ef27fd1df",
      "platform": "tiktok",
      "profileId": "6a0b6573846efc28aaa9a3ff",
      "username": "acme",
      "displayName": "Acme",
      "platformUserId": "60c5beb6ca4037bb9ff5117a",
      "scopeAreas": [
        "string"
      ],
      "oauthAppId": "629a39de8c0a63af5a05067c",
      "tiktokAccountType": "business",
      "profilePicture": "string",
      "profileUrl": "https://pozy.ai/media/example-1.jpg",
      "isActive": true,
      "needsReconnection": true,
      "followersCount": 12.5,
      "followersLastUpdated": "2026-10-02T09:00:00.000Z",
      "parentAccountId": "6ce971ffa48fe63468db336b",
      "enabled": true,
      "rateLimitedUntil": "2026-10-02T09:00:00.000Z",
      "metadata": {}
    }
  ],
  "hasAnalyticsAccess": true,
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 42,
    "pages": 1
  },
  "profileTotals": {
    "key": 1
  },
  "statusCounts": {
    "all": 1,
    "disconnected": 1
  }
}
```