---
title: "List placements (account-wide)"
method: GET
path: "/api/placements"
tags: ["Placements"]
---

# List placements (account-wide)

`GET /api/placements`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/placements`
- Auth: HTTP bearer

Retrieves every placement on the account, across all platforms and profile groups, including which connected profile actively serves each one. Requires an account-wide API key (one not scoped to a profile group); a group-scoped key returns 422. Sandbox API keys list sandbox placements; live keys list live placements. Default per_page is 25 (maximum 100).

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Paginated list of placements

- object: Envelope for paginated list responses.
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `data` Placement[], required
    - `id` string: Placement ID. Postproxy's own ID, used in placement URLs — not the platform ID.
    - `platform` 'facebook' | 'linkedin' | 'pinterest' | 'telegram' | 'google_business': Platform the placement belongs to.
    - `external_id` string: Platform-specific ID — the value used as page_id / chat_id when creating posts, and returned as id by the per-profile List placements endpoint.
    - `name` string: Placement name.
    - `avatar_url` string, nullable: Stable Postproxy storage URL of the placement's picture, resized to 256x256 (Facebook Pages). null until it has been mirrored and for networks without one.
    - `status` 'active' | 'orphaned' | 'removed': active (the active profile is connected), orphaned (the active profile is disconnected — posting is paused until you switch to a connected profile), or removed (access was revoked on the platform).
    - `active_profile` PlacementProfileRef: Compact profile reference on a placement.
      - `id` string: Profile ID.
      - `name` string: Profile display name.
      - `connected` boolean: Whether the profile is currently connected.
    - `linked_profiles` PlacementProfileRef[]: Every profile that can see this placement — the candidates for Set active profile.
      - `id` string: Profile ID.
      - `name` string: Profile display name.
      - `connected` boolean: Whether the profile is currently connected.

## Other responses

- `401`: Invalid, missing, or insufficient API key permissions.
- `422`: API key is scoped to a profile group — an account-wide key is required.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)