> ## 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.

# List Placements

> Your workspace's in-app placements with their counts

Lists your workspace's [placements](https://docs.sequenzy.com/concepts/in-app-placements.md), sorted by name. Each comes with all-time counts for the in-app items that targeted it: `created` items, and the contacts with a `live` item (not dismissed and not expired) or who `displayed`, `clicked` or `dismissed` their item. Displayed, clicked and dismissed depend on your app [reporting events](https://docs.sequenzy.com/api-reference/in-app/record-event.md); the SDK placement views do this for you. Requires the `sequences:read` scope.

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

```json 200 theme={null}
{
  "success": true,
  "placements": [
    {
      "key": "home_hero",
      "name": "Home hero",
      "description": "Top of the home screen",
      "width": 360,
      "height": 160,
      "createdAt": "2026-11-07T10:00:00.000Z",
      "updatedAt": "2026-11-07T10:00:00.000Z",
      "stats": {
        "placement": "home_hero",
        "created": 1240,
        "live": 980,
        "displayed": 1012,
        "clicked": 187,
        "dismissed": 160
      }
    }
  ]
}
```

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

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


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