---
search:
  tags:
    - Library placement groups
    - GET
seo:
  description: >-
    Lists the live Placement groups that your organization sees, newest first:
    its… Reference for the GET /library/placement-groups endpoint in the
    AdCrunch API.
sidebar:
  label: List the Placement groups
  badge: GET
title: List the Placement groups
type: openapi-operation
---
Lists the live Placement groups that your organization sees, newest first: its own, and the global ones, one for each channel that has Placements. A group holds no Placement in this list. The read of one group holds them. `isGlobal` tells you which rows you cannot change.

One page at a time: `limit` rows at most, 100 by default. When the answer holds `nextCursor`, more rows exist: send it back as `cursor` to get the next page.

`GET /library/placement-groups`

**Responses**

- `200` — One page of the groups, newest first. This page is the last one, so it carries no \`nextCursor\`.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`library:read\`. \`error\` is \`forbidden\`.

Response example, 200:

```json
{
  "data": [
    {
      "createdAt": 1790000600000,
      "createdBy": "usr_2e5b84",
      "deletedAt": null,
      "description": null,
      "id": "plg_9e1c53",
      "isGlobal": false,
      "name": "Vertical video",
      "organizationId": "org_3a7f10",
      "updatedAt": null
    },
    {
      "createdAt": 1789000000000,
      "createdBy": null,
      "deletedAt": null,
      "description": null,
      "id": "plg_meta",
      "isGlobal": true,
      "name": "Meta",
      "organizationId": null,
      "updatedAt": null
    }
  ]
}
```
