---
title: "List replies"
method: GET
path: "/replies"
tags: ["Replies"]
---

# List replies

`GET /replies`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/replies`
- Auth: HTTP bearer

Lists inbound emails (replies received from prospects) in the API key's workspace, newest first, 20 per page by default (?limit= up to 200). Filter by AI response category, campaign, lead, or a time floor. responseCategory is null while AI categorization is still pending; campaignId is null for standalone replies that could not be attributed to a campaign. This list is read-only. To answer a reply, send your own message with POST /replies/{id}/reply, or send its AI draft: edit it (PUT /reply-drafts/{id}) and send it (POST /reply-drafts/{id}/send) - the draft's current subject and body are what goes out.

## Query parameters

- `category` string
- `campaignId` integer
- `leadId` integer
- `since` string
- `page` integer
- `limit` integer

## Response `200`

List of replies

- ModelsListRepliesResponse
  - `hasMore` boolean
  - `limit` integer
  - `page` integer
  - `replies` ModelsReplyItem[]
    - `body` string
    - `campaignId` integer: CampaignID is null for standalone replies that could not be attributed to a campaign.
    - `fromAddress` string
    - `id` integer
    - `leadId` integer
    - `mailboxAddress` string: MailboxAddress is the workspace mailbox the reply came in to. Left out when no workspace mailbox can be named.
    - `receivedAt` string
    - `responseCategory` string: ResponseCategory is null while AI categorization is still pending.
    - `stepIndex` integer: StepIndex is the sequence step of the campaign email this reply answers: 0 = initial email, 1..N = follow-ups in chain order, the numbering of the campaign's step stats. Left out when the reply answers no sequence email.
    - `subject` string
    - `threadId` string
  - `total` integer

## Other responses

- `400`: Invalid query parameters
- `401`: Unauthorized - invalid or missing API key
- `404`: Campaign or lead filter not found
- `500`: Failed to retrieve replies

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)