> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Placement

> One in-app placement with its counts

Returns one [placement](https://docs.sequenzy.com/concepts/in-app-placements.md) and the all-time counts for the in-app items that targeted it, as in [List Placements](https://docs.sequenzy.com/api-reference/in-app/list-placements.md). Requires the `sequences:read` scope.

## Request

**key** `string` *required*

The placement key, for example `home_hero`.

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/in-app/placements/home_hero" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "placement": {
    "key": "home_hero",
    "name": "Home hero",
    "description": "",
    "width": 360,
    "height": null,
    "createdAt": "2026-11-07T10:00:00.000Z",
    "updatedAt": "2026-11-07T10:00:00.000Z",
    "stats": {
      "placement": "home_hero",
      "created": 12,
      "live": 10,
      "displayed": 8,
      "clicked": 2,
      "dismissed": 1
    }
  }
}
```

```json 401 theme={null}
{
  "error": "Invalid API key"
}
```

```json 403 theme={null}
{
  "error": "API key is missing required scope: sequences:read"
}
```

```json 404 theme={null}
{
  "error": "Placement \"home_hero\" not found."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.