# Receipts for a conversation

`GET /api/reporting/v1/conversations/{phone}/receipts`  (operationId: `conversationReceipts`, group: Reporting)

Delivery and read receipts for the outbound messages in a chat, most recent first, in one call. Receipts exist from the day recording began; earlier messages show only their latest status.

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `inbox`, `contacts`, `inbox:read`, `contacts:read`. Chat content: messages, names and phone numbers.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `phone` | path | string | yes | Contact phone number with the country code, digits only. A leading + is accepted. A 10-digit number with no country code is treated as Indian (91 is added). |
| `since` | query | string (date-time) | no | Only messages at or after this time. |
| `to` | query | string (date-time) | no | End of the window (ISO 8601 or date). Default: now. Alias: until. |
| `limit` | query | integer | no | Page size, 1 to 200. Default 100. Default 100. |

**Response 200**: OK (schema `ConversationReceipts`)

| Field | Type | Description |
| --- | --- | --- |
| `phone` | string |  |
| `data` | array of object |  |
| `data[][].message_id` | string |  |
| `data[][].sent_at` | string (date-time) |  |
| `data[][].sender_type` | string | customer: the contact. bot: the AI agent. agent: a team member (recorded on messages sent from InboxWA). system: any other outbound message (automation, campaign, template, or an older message with no recorded author). A bot reply is never reported as a human. One of: `customer`, `bot`, `agent`, `system`. |
| `data[][].current_status` | string, nullable |  |
| `data[][].receipts` | array of Receipt |  |
| `data[][].receipts[][].status` | string | One of: `sent`, `delivered`, `read`, `failed`. |
| `data[][].receipts[][].at` | string (date-time) | When WhatsApp reported it. |
| `data[][].receipts[][].error` | string | Failure reason. |

Example:

```json
{
  "phone": "919876543210",
  "data": [
    {
      "message_id": "wamid.HBgM...A1",
      "sent_at": "2026-10-02T09:05:12.000Z",
      "sender_type": "agent",
      "current_status": "read",
      "receipts": [
        {
          "status": "sent",
          "at": "2026-10-02T09:05:12.000Z"
        },
        {
          "status": "delivered",
          "at": "2026-10-02T09:05:14.000Z"
        },
        {
          "status": "read",
          "at": "2026-10-02T09:05:50.000Z"
        }
      ]
    }
  ]
}
```

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json