---
title: "Get an account"
method: GET
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Get an account

`GET /accounts/{id}`

## Request

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

One connected account: its network, handle, profile, status, billing, what it can do (`capabilities`) and the formats it publishes.

## Path parameters

- `id` string, required: The account's id (`acc_`).

## Response `200`

OK

- Account
  - `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.

## 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)
