> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchthegoodones.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List tracked accounts

> List the active + sleeping tracked X accounts for the authenticated user

Lists the user's tracked accounts. Discovery surface for the sleep / wake / change-tier verbs. There is no `POST /api/v2/accounts` - tracked accounts are upserted as a side effect of stream creation (see [POST /api/v2/streams](/api-reference/create-stream)).

## Example

```bash theme={null}
curl https://www.catchthegoodones.com/api/v2/accounts \
  -H "Authorization: Bearer ctgo_your_api_key_here"
```

## Response

```json theme={null}
{
  "active": [
    {
      "id": 7,
      "xHandle": "yongfook",
      "tier": "starter",
      "isActive": true,
      "profileImageUrl": "https://pbs.twimg.com/profile_images/...",
      "lastKnownFollowerCount": 12500,
      "lastKnownTweetCount": 4321,
      "tags": [],
      "addedAt": "2026-03-01T00:00:00Z",
      "assignedSegmentIds": [12, 13],
      "pendingTier": null,
      "pendingTierEffectiveAt": null
    }
  ],
  "sleeping": []
}
```

## Response fields

| Field                  | Type         | Description                                                                         |
| ---------------------- | ------------ | ----------------------------------------------------------------------------------- |
| `active[]`             | array        | Currently-tracked accounts (synced + billed)                                        |
| `sleeping[]`           | array        | Accounts that have been slept (paused; not billed)                                  |
| `tier`                 | enum         | `"starter"`, `"growth"`, `"pro"`                                                    |
| `assignedSegmentIds[]` | number\[]    | Segment IDs assigned via any active stream containing this account                  |
| `pendingTier`          | enum or null | Scheduled tier change effective at `pendingTierEffectiveAt` (end of billing period) |

For subscription summary + credits + budgets, see [GET /api/v2/me](/api-reference/me).

## Auth

Bearer or session cookie.