---
title: "List AI Inbox Manager replies"
method: GET
path: "/api/v2/ai-agents/inbox-manager/{id}/replies"
tags: ["AIInboxManager"]
---

# List AI Inbox Manager replies

`GET /api/v2/ai-agents/inbox-manager/{id}/replies`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/ai-agents/inbox-manager/{id}/replies`
- Auth: HTTP bearer

List the replies and follow-ups generated by an AI Inbox Manager, newest first.


Requires one of the following scopes: `ai_sdr_replies:read`, `ai_agents:all`, `all:read`, `all:all`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `starting_after` string
- `requires_hitl` boolean
- `information_requested` boolean
- `action_pending` boolean

## Response `200`

The replies generated by the AI Inbox Manager

- object
  - `items` AISalesAgentReply[], required: The list of replies
    - `id` string, uuid, required: Unique identifier for the AI Sales Agent reply
    - `organization_id` string, uuid, nullable: Organization ID
    - `timestamp_created` string, nullable: Timestamp when the AI Sales Agent reply was created (ISO 8601)
    - `timestamp_updated` string, nullable: Timestamp when the AI Sales Agent reply was last updated (ISO 8601)
    - `agent_id` string, uuid, nullable: ID of the AI agent that generated this reply (nullable)
    - `thread_id` string, nullable: Conversation thread identifier (nullable)
    - `lead` string, nullable: Lead email address this reply is associated with
    - `feedback_positive` boolean, nullable: Whether the feedback on the reply was positive (nullable)
    - `feedback_text` string, nullable: Feedback text left by a user for this reply (nullable)
    - `html` string, nullable: HTML-formatted reply (nullable)
    - `requires_hitl` boolean, nullable: If true, the reply requires human-in-the-loop review (nullable)
    - `requires_hitl_reason` string, nullable: Reason why human-in-the-loop review is required (nullable)
    - `generation_lag_seconds` number, nullable: Time taken (in seconds) for AI to generate the reply (nullable)
    - `is_automatic_email` boolean, nullable: Whether this reply was automatically sent as an email (nullable)
    - `in_reply_to` string, nullable: ID of the reply this message is in response to (nullable)
    - `usage_metadata` object: JSON object with OpenAI usage, costs, and prompt data (nullable)
    - `calendly_tool_used` boolean, nullable: Whether the Calendly scheduling tool was used in this reply
    - `confidence_score` number, nullable: Confidence score for this AI-generated reply (nullable, 0-100)
    - `information_requested` string, nullable: Text the AI used to request more information (nullable)
    - `estimated_time_saved_seconds` number, nullable: Estimated time (in seconds) saved by the AI in generating this reply (nullable)
    - `action_pending` boolean, nullable: Whether this reply requires pending action from the user (nullable)
    - `sending_status` -1 | 1 | 2: Status of the email sending process
    - `is_followup` boolean, nullable: Whether this reply is an automatic follow-up to a previous reply (nullable)
    - `error_code` 'NO_SENDING_ACCOUNT' | 'ACCOUNT_INACTIVE' | 'ACCOUNT_FETCH_FAILED' | 'SEND_FAILED' | 'HITL_NOT_SUPPORTED' | 'RATE_LIMITED' | 'AGENT_NOT_FOUND' | 'LEAD_BLOCKED' | 'FREE_TRIAL_LIMIT_REACHED' | 'OUT_OF_CREDITS' | 'MONTHLY_BUDGET_EXCEEDED': Error code for the email sending process (nullable)
  - `next_starting_after` string: Pass as `starting_after` to fetch the next page. Absent on the last page.

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

## Changes

- **2026-11-03** `c781051105a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/ai-agents/inbox-manager/:id/replies/get.md)

---

[API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/406ab2c4f714?raw)