# List brands, groups and connected accounts

> List brands, groups and connected accounts with the Wavegrain Posting API: GET /api/v1/accounts. Responses and an example request.

> Index of these docs: https://wavegrain.com/developers/llms.txt

`GET /api/v1/accounts` is part of the [Posting API](/developers/posting-api). Every call needs an access key: see [Authentication](/developers/authentication).

Needs the `read` permission.

Every connected account with its network, groups, posts in the last 24 hours, the network's daily limit and how many posts it may still send today. `networks` says what each network can do on Wavegrain now, for example TikTok posting as Only me before its audit.

## Example request

```bash
curl https://wavegrain.com/api/v1/accounts \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Success |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 429 | Too many requests for the key or the account |
| 500 | Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing. |

A successful answer:

```json
{
  "brands": [
    {
      "id": "brd_K3m9",
      "name": "Koi Kitchen",
      "timeZone": "Europe/Berlin",
      "groups": [
        {
          "id": "grp_7Qa1",
          "name": "Main",
          "isDefault": true,
          "notes": "",
          "avoid": [],
          "accountIds": [
            "acc_4Ft7Wz"
          ]
        }
      ]
    }
  ],
  "accounts": [
    {
      "id": "acc_4Ft7Wz",
      "network": "instagram",
      "name": "Koi Kitchen",
      "status": "connected",
      "reconnectBy": null,
      "groupIds": [
        "grp_7Qa1"
      ],
      "postsLast24h": 2,
      "dailyLimit": 50,
      "leftToday": 48,
      "capReached": null
    }
  ],
  "networks": [
    {
      "network": "instagram",
      "name": "Instagram",
      "state": "ready",
      "note": null,
      "autoPost": true,
      "needsOptIn": false
    }
  ]
}
```

## More in the Posting API

- [List posts](/developers/api/list-posts): `GET /api/v1/posts`
- [Create a post](/developers/api/create-post): `POST /api/v1/posts`
- [Get a post](/developers/api/get-post): `GET /api/v1/posts/{id}`
- [Cancel a post](/developers/api/cancel-post): `DELETE /api/v1/posts/{id}`
- [Start an image or video upload](/developers/api/create-upload): `POST /api/v1/media`
- [Get an upload](/developers/api/get-upload): `GET /api/v1/media/{id}`
- [Delete a video](/developers/api/delete-video): `DELETE /api/v1/media/{id}`
- [Finish and check a video upload](/developers/api/complete-video-upload): `POST /api/v1/media/{id}/complete`
- [Write captions](/developers/api/write-captions): `POST /api/v1/captions`
- [All endpoints](/developers/api)
