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

# List Messages

> List connector messages with filters and cursor pagination

## Endpoint

`GET https://api.apifycloud.io/api/v1/analytics/{appId}/messages`

## Authentication

Bearer token required.

Scope: `messages:read`

## Path parameters

* `appId` (UUID, required)

## Query parameters

* `limit` (number, optional)
* `cursor` (string, optional)
* `status` (string, optional)
* `direction` (string, optional) e.g. `inbound`, `outbound`
* `channel` (string, optional) e.g. `whatsapp`
* `messageType` (string, optional) provider message type
* `source` (string, optional) connector source system
* `destination` (string, optional) connector destination system
* `search` (string, optional) matches `user_phone`, `provider_message_id`, `conversation_key`, `provider_from`, `provider_to`
* `startDate` (string, optional) ISO date (YYYY-MM-DD)
* `endDate` (string, optional) ISO date (YYYY-MM-DD)

## Response

```json theme={null}
{
  "data": [
    {
      "id": "string",
      "source": "string",
      "destination": "string",
      "provider_from": "string",
      "provider_to": "string",
      "channel": "whatsapp",
      "direction": "outbound",
      "message_type": "template",
      "user_phone": "573001112233",
      "conversation_key": "string",
      "provider_message_id": "string",
      "status": "string",
      "sent_at": "2024-01-01T00:00:00.000Z",
      "failed_at": null,
      "error_message": null,
      "created_at": "2024-01-01T00:00:00.000Z",
      // ... more connector fields are available in detail endpoint
    }
  ],
  "meta": {
    "timestamp": "2024-01-01T00:00:00.000Z"
  },
  "pagination": {
    "limit": 25,
    "hasMore": false,
    "nextCursor": null
  }
}
```

## Errors

* `403 forbidden` unauthorized for app or missing scope
* `400 validation_error` invalid query parameters
* `429 rate_limit_exceeded`
* `500 server_error`

## Example

```bash theme={null}
curl "https://api.apifycloud.io/api/v1/analytics/{appId}/messages?limit=25&direction=outbound&channel=whatsapp&search=57300" \
  -H "Authorization: Bearer {access_token}"
```