List accounts

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

GET/v1/accounts

API key (dra_…) or dashboard JWT

List connected social accounts with keyset pagination and optional filters.

Authorizationstringheaderrequired

Bearer token. Use a Dravo API key (`dra_…`) or a dashboard JWT.

platformstringquery

Filter by platform.

qstringquery

Search on handle/metadata.

limitintquery

1 to 100 (default 50).

cursorstringquery

Pagination cursor.

itemsobject[]

Connected accounts; each has the fields below.

idstring

Connected account id.

platformstring

Platform: meta, instagram, facebook, x, linkedin or tiktok.

handlestringoptional

Account handle/username.

healthstring

active, expiring, expired or requires_reconnect.

connection_typestring

Always oauth.

next_cursorstringoptional

Cursor for the next page; null on the last page.

totalinteger

Total connected accounts.

const response = await fetch("https://api.dravo.dev/v1/accounts", {  method: "GET",  headers: {  "Authorization": "Bearer " + process.env.DRAVO_API_KEY,}});const data = await response.json();console.log(data);

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