---
search:
  tags:
    - Library placement groups
    - GET
seo:
  description: >-
    Reads one Placement group that your organization sees, with every… Reference
    for the GET /library/placement-groups/{groupId} endpoint in the AdCrunch
    API.
sidebar:
  label: Get one Placement group
  badge: GET
title: Get one Placement group
type: openapi-operation
---
Reads one Placement group that your organization sees, with every live Placement that it holds, on one page with no cursor. A group of another organization answers `404`, so this API does not confirm that an id exists somewhere else.

`GET /library/placement-groups/{groupId}`

**Responses**

- `200` — The group, with its Placements.
- `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.
- `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\`.
- `404` — No Placement group with that id that your organization sees. A deleted group answers this too. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "createdAt": 1790000600000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "description": null,
  "id": "plg_9e1c53",
  "isGlobal": false,
  "name": "Vertical video",
  "organizationId": "org_3a7f10",
  "updatedAt": null,
  "placements": [
    {
      "channel": "meta",
      "createdAt": 1790000500000,
      "createdBy": "usr_2e5b84",
      "deletedAt": null,
      "description": "Our own cut for Reels, never over 30 seconds.",
      "id": "plm_4b8d27",
      "isGlobal": false,
      "name": "Reels short cut",
      "organizationId": "org_3a7f10",
      "params": {
        "rules": [
          {
            "operator": {
              "condition": "eq",
              "value": [
                9,
                16
              ]
            },
            "type": "ratio"
          },
          {
            "operator": {
              "condition": "lte",
              "value": 30000
            },
            "type": "duration"
          }
        ],
        "type": "video"
      },
      "type": "video",
      "updatedAt": null
    },
    {
      "channel": "meta",
      "createdAt": 1789000000000,
      "createdBy": null,
      "deletedAt": null,
      "description": null,
      "id": "plm_meta_stories_video",
      "isGlobal": true,
      "name": "Meta Stories video",
      "organizationId": null,
      "params": {
        "rules": [
          {
            "operator": {
              "condition": "eq",
              "value": [
                9,
                16
              ]
            },
            "type": "ratio"
          },
          {
            "operator": {
              "condition": "gte",
              "value": 250
            },
            "type": "width"
          },
          {
            "operator": {
              "condition": "in",
              "value": [
                "video/mp4",
                "video/quicktime"
              ]
            },
            "type": "mime"
          },
          {
            "operator": {
              "condition": "gte",
              "value": 1000
            },
            "type": "duration"
          }
        ],
        "type": "video"
      },
      "type": "video",
      "updatedAt": null
    }
  ]
}
```
