---
title: "List accounts"
description: "List the connected social accounts you can publish to."
section: "API reference"
url: https://dravo.dev/docs/api/accounts/list
---
# List accounts

List your connected accounts with keyset pagination and optional filters by
platform or handle.

#### `GET /v1/accounts`

List connected social accounts with keyset pagination and optional filters.

**Auth:** API key (`dra_…`) or dashboard JWT

| Field | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `platform` | query | string | no | Filter by platform. |
| `q` | query | string | no | Search on handle/metadata. |
| `limit` | query | int | no | 1 to 100 (default 50). |
| `cursor` | query | string | no | Pagination cursor. |

Response `200`: A page of accounts.

```json
{
  "items": [
    {
      "id": "acc_8f2c1d",
      "platform": "x",
      "handle": "@dravo",
      "health": "active",
      "connection_type": "oauth"
    }
  ],
  "next_cursor": null,
  "total": 1
}
```