> ## 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 In-App Campaigns

> List in-app campaigns, newest first

Lists in-app campaigns, newest first. Each campaign has a stored `status` and a `state` that tells live and ended campaigns apart: `draft`, `scheduled`, `live`, `ended` (past its end time) or `stopped`. In-app campaigns also appear in [List Campaigns](https://docs.sequenzy.com/api-reference/campaigns/list.md) with type `in_app`. Requires the `campaigns:read` scope.

## Request

**status** `string`

Stored status: `draft`, `scheduled`, `sent` (live or ended) or `cancelled` (stopped).

**limit** `number` (default: 50)

Page size, 1 to 100.

**offset** `number` (default: 0)

Number of campaigns to skip.

```bash theme={null}
curl -X GET "https://api.sequenzy.com/api/v1/in-app/campaigns?status=sent" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY"
```

## Responses

```json 200 theme={null}
{
  "success": true,
  "campaigns": [
    {
      "id": "cmp_abc123",
      "name": "New dashboards",
      "type": "in_app",
      "status": "sent",
      "state": "live",
      "message": {
        "label": "",
        "kind": "message",
        "format": "modal",
        "title": "Hi {{firstName}}, dashboards are here",
        "body": "See every campaign at a glance.",
        "buttons": [
          {
            "label": "Take a look",
            "action": "open_url",
            "url": "myapp://dashboards"
          }
        ]
      },
      "priority": "high",
      "endsAt": "2026-12-01T00:00:00.000Z",
      "targetLists": {
        "type": "segment",
        "segmentId": "seg_123"
      },
      "scheduledAt": null,
      "sentAt": "2026-11-08T09:00:00.000Z",
      "estimatedRecipientCount": 1200,
      "labelIds": [],
      "createdAt": "2026-11-07T12:00:00.000Z",
      "updatedAt": "2026-11-08T09:00:00.000Z"
    }
  ],
  "total": 1
}
```

```json 400 theme={null}
{
  "error": "limit must be at most 100"
}
```

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

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


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