---
title: "List connected accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List connected accounts

`GET /accounts`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/accounts`
- Auth: HTTP bearer

Every account without `limit`; with it, a page at a time: pass `nextCursor` as `cursor` for the next one, with the same filters.

## Query parameters

- `profileId` string: Only this profile's (`prof_`): one brand or client, from List profiles. A profile you do not reach is refused as not found.
- `status` 'connected' | 'expiring' | 'disconnected': connected: works. expiring: reconnect before `reconnectBy`. disconnected: the network revoked access; reconnect to publish again.
- `limit` integer: How many to return. Left out: every account.
- `cursor` string: `nextCursor` from the page before, with the same filters.

## Response `200`

OK

- object
  - `items` Account[], required
    - `id` string, required
    - `profileId` string, required
    - `network` 'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google', required
    - `handle` string, required
    - `name` string, required
    - `status` 'connected' | 'expiring' | 'disconnected', required: connected: works. expiring: reconnect before `reconnectBy`. disconnected: the network revoked access; reconnect to publish again.
    - `billing` 'active' | 'awaiting_payment' | 'paused', required: active: covered by the plan. awaiting_payment: connected, and live once its payment succeeds (a team's third account starts a paid plan; on a paid plan, added accounts are charged when they connect; those a connect link adds beyond the owner's cap wait for an owner to pay). paused: the team's payment failed for 14 days or its paid plan ended, so only 2 accounts stay active; nothing is deleted. Accounts that are not active do not publish or send messages. Rizamo reads no posts, numbers or comments of an account awaiting payment, and reads a paused one for 30 days.
    - `followers` integer, required
    - `avatarUrl` string, nullable, required: Its picture. On Facebook, Instagram, Threads, TikTok and LinkedIn, whose own links expire, a small copy Rizamo keeps, on Rizamo's media host: the link works for a few hours, so get the account again for a fresh one. The network's own link elsewhere, and until the copy is made. Null when the network gives none, or its link expired with no copy.
    - `connectionId` string, required: The login this account came through. One login can bring several accounts, and one reconnect fixes them all.
    - `reconnectBy` string, date-time, nullable, required: When the network will end access unless someone logs in again (TikTok: a year after the first login; LinkedIn: 60 days after each login; Threads: 90 days after the login, moved on while Rizamo refreshes a public profile's token).
    - `capabilities` Capability[], required: What this account can do, from its login, your role on the network and the account's level. The API refuses the rest with `capability_missing`.
    - `formats` PostFormat[], required: The formats this account can publish.
  - `nextCursor` string, nullable, required: Null on the last page, and without `limit`.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
