# Replies across the workspace

`GET /api/reporting/v1/replies`  (operationId: `listReplies`, group: Reporting)

Outbound messages in the window, newest first, filterable by team member and sender type, each with its response time. Use it to audit one person, or to see what the bot answered.

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `inbox`, `team_management`, `analytics`, `inbox:read`, `team_management:read`, `analytics:read`. Team accountability data: who opened, who replied, how fast.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `since` | query | string (date-time) | no | Start of the window: an ISO 8601 timestamp or a date (YYYY-MM-DD, start of that UTC day). Default: 7 days ago. Alias: from. |
| `to` | query | string (date-time) | no | End of the window (ISO 8601 or date). Default: now. Alias: until. |
| `agent_id` | query | integer | no | Only replies sent by this team member. |
| `sender_type` | query | string | no | Only this kind of sender. One of: `agent`, `bot`, `system`. |
| `phone` | query | string | no | Only this contact. |
| `limit` | query | integer | no | Page size, 1 to 200. Default 50. Default 50. |
| `cursor` | query | string | no | The next_cursor from the previous page. Treat it as opaque. |

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

| Field | Type | Description |
| --- | --- | --- |
| `data` | array of object |  |
| `data[][].message_id` | string, nullable |  |
| `data[][].phone` | 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[][].actor` | object, nullable |  |
| `data[][].sender_label` | string, nullable |  |
| `data[][].status` | string, nullable |  |
| `data[][].response_seconds` | integer, nullable |  |
| `next_cursor` | string, nullable |  |
| `window` | Window |  |
| `window.from` | string (date-time) | Start of the window. |
| `window.to` | string (date-time) | End of the window. |

Example:

```json
{
  "data": [
    {
      "message_id": "wamid.HBgM...A1",
      "phone": "919876543210",
      "sent_at": "2026-10-02T09:05:12.000Z",
      "sender_type": "agent",
      "actor": {
        "user_id": 41,
        "name": "Anita"
      },
      "sender_label": "Anita",
      "status": "read",
      "response_seconds": 312
    }
  ],
  "next_cursor": null,
  "window": {
    "from": "2026-09-25T09:30:00.000Z",
    "to": "2026-10-02T09:30:00.000Z"
  }
}
```

**Errors specific to this call.** The common ones (401, 403, 429 and the rest) are in the [Errors guide](https://inboxwa.online/docs/api/guide/errors.md).

| Status | error | When |
| --- | --- | --- |
| 400 | `invalid_agent_id` | agent_id is not a user id. |
| 400 | `invalid_sender_type` | sender_type is not agent, bot or system. |

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