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

# List your connected social accounts

`GET /accounts`

## Request

- Base URL: `https://www.juzpost.com/api/cli/v1`
- URL: `https://www.juzpost.com/api/cli/v1/accounts`
- Auth: HTTP bearer

Returns connected social accounts, newest first by default. Use the returned `id` values
as `socialAccountIds` when scheduling. Access and refresh tokens are never included in
the response. Results are cursor-paginated: pass `pagination.nextCursor` back as
`cursor` to get the next page, and stop when `pagination.hasMore` is false.

## Query parameters

- `limit` integer
- `cursor` string
- `order` 'asc' | 'desc'
- `sort` 'createdAt' | 'username' | 'platform'
- `platform` string
- `groupId` string, uuid

## Response `200`

One page of connected accounts.

- AccountPage: A page of connected social accounts.
  - `data` Account[], required: The accounts in this page.
    - `id` string, uuid, required: The account id. Pass these values in `socialAccountIds` when scheduling.
    - `username` string, required: The handle or channel name on the platform.
    - `platform` string, required: Which network this account is on, for example `tiktok`, `youtube`, `instagram`, `x`, `bluesky` or `pinterest`.
    - `avatarUrl` string, nullable, required: Profile picture URL, or null if the platform gave none.
    - `isActive` boolean, required: Whether the connection is still usable. An inactive account normally needs reconnecting in the dashboard before it can publish.
    - `createdAt` string, date-time, required: When the account was connected.
  - `pagination` PaginationMeta, required: Page state returned by every list operation. Keyset-based, so it stays correct while rows are being inserted, and it deliberately carries no total count.
    - `limit` integer, required: The page size actually applied, after clamping to 1-100.
    - `nextCursor` string, nullable, required: Pass this back as the `cursor` query parameter to fetch the next page. It is `null` when there is no next page.
    - `hasMore` boolean, required: True when at least one more page exists. Stop paginating when this is false rather than when the data array is short.

## Other responses

- `400`: The request body or query string failed validation. `error.message` names the first problem found.
- `401`: No bearer token was sent, or the token is unknown, revoked or malformed. Run the device login again to obtain a new token.
- `402`: The plan behind this token does not include the capability this operation needs. `error.details.requiredPlan` names the tier that does. This is never a token problem, so do not retry without changing the plan.

---

[API](https://skmtc.dev/juzpost/apis/juzpost-rest-api.md) · [All operations](https://skmtc.dev/juzpost/apis/juzpost-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/juzpost/apis/juzpost-rest-api/revisions/19296da24f95?raw)