---
search:
  tags:
    - Library placements
    - GET
seo:
  description: >-
    Reads one Placement that your organization sees: its own, or a global…
    Reference for the GET /library/placements/{placementId} endpoint in the
    AdCrunch API.
sidebar:
  label: Get one Placement
  badge: GET
title: Get one Placement
type: openapi-operation
---
Reads one Placement that your organization sees: its own, or a global one. `params` holds the type and the rules. A Placement of another organization answers `404`, so this API does not confirm that an id exists somewhere else.

`GET /library/placements/{placementId}`

**Responses**

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

Response example, 200:

```json
{
  "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
}
```
