---
title: "Get an organisation's affiliated X accounts"
method: GET
path: "/v1/x/users/{user}/affiliates"
tags: ["X"]
---

# Get an organisation's affiliated X accounts

`GET /v1/x/users/{user}/affiliates`

## Request

- Base URL: `https://api.weirapp.io`
- URL: `https://api.weirapp.io/v1/x/users/{user}/affiliates`
- Auth: HTTP bearer

Returns the accounts a Verified Organization lists as affiliated with it, such as its employees, products, or regional accounts. Empty for accounts that are not Verified Organizations. 404 when the account does not exist, or is protected: a protected account's posts and connections are visible only to accounts it approved. Billed per account returned. The first page also bills one profile lookup, to resolve `{user}`; later pages carry the account in the cursor and do not.

## Path parameters

- `user` string, required: A username, with or without the `@`, or a numeric account id. An all-digit value is read as an id.

## Query parameters

- `limit` integer: Most accounts to return. X may return fewer.
- `cursor` string: Opaque cursor from the previous page's `meta.nextCursor`. Pass it back unchanged, with the same path and query parameters; a cursor from another request is rejected with 400.

## Response `200`

Affiliated accounts.

- object
  - `data` object[], required
    - `id` string, required
    - `username` string, required: Handle without the `@` prefix.
    - `name` string, required: Display name.
    - `description` string, nullable, required
    - `url` string, required
    - `profileImageUrl` string, nullable, required
    - `profileBannerUrl` string, nullable, required
    - `location` string, nullable, required
    - `verified` boolean, required
    - `followersCount` integer, required
    - `followingCount` integer, required
    - `statusesCount` integer, required: Posts published.
    - `likeCount` integer, required
    - `createdAt` string, date-time, required
    - `pinnedPostIds` string[], required: Ids of the posts pinned to the top of the profile, usually zero or one.
    - `protected` boolean, required: True when only approved followers can see this account's posts. Its posts, replies, media, and relationship lists are then not available through this API.
  - `meta` object, required
    - `requestId` string, required
    - `nextCursor` string, nullable

## Other responses

- `400`: The request failed validation.
- `401`: The API key is missing, malformed, expired, or revoked.
- `402`: The account is out of credit. Not retryable: this cannot clear until the billing period resets or the plan changes.
- `403`: The API key does not carry the scope this route requires.
- `404`: The requested resource does not exist.
- `429`: The per-minute rate limit is exhausted. Retryable: wait for Retry-After and try again.
- `500`: An unexpected error occurred.
- `503`: The source is temporarily unavailable. The request is safe to retry.

---

[API](https://skmtc.dev/weirapp/apis/weir-api.md) · [All operations](https://skmtc.dev/weirapp/apis/weir-api/llms.txt) · [OpenAPI document](https://skmtc.dev/weirapp/apis/weir-api/revisions/4c6a9ae0bfca?raw)