List Replies

Retrieve a list of replies in your workspace

GET /api/replies

List Replies

cURL

curl --request GET \
  --url https://api.example.com/api/replies

200

{
  "data": [
    {
      "id": "<string>",
      "from_email": "<string>",
      "from_name": "<string>",
      "to_email": "<string>",
      "subject": "<string>",
      "body_text": "<string>",
      "body_html": "<string>",
      "status": "<string>",
      "category_id": "<string>",
      "category": {},
      "ai_response": "<string>",
      "sent_response": "<string>",
      "client_id": "<string>",
      "connection_id": "<string>",
      "contact_id": "<string>",
      "received_at": "<string>",
      "handled_at": "<string>",
      "created_at": "<string>"
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "hasMore": true
  }
}

Fetch all replies with optional filtering and pagination.

Query Parameters

status · string

Filter by reply status. Options: pending, ready, sent, archived

category_id · string

Filter by category UUID

client_id · string

Filter by client UUID

connection_id · string

Filter by connection UUID

search · string

Search by email address, name, or subject

limit · integer · default: "20"

Number of replies to return (max 100)

offset · integer · default: "0"

Number of replies to skip for pagination

Response

data · array

Array of reply objects

Show Reply Object

id · string

Unique reply identifier (UUID)

from_email · string

Sender’s email address

from_name · string

Sender’s name (if available)

to_email · string

Recipient email address

subject · string

Email subject line

body_text · string

Plain text email body

body_html · string

HTML email body (if available)

status · string

Reply status: pending, ready, sent, archived

category_id · string

Category UUID

category · object

Category details including name and color

ai_response · string

AI-generated draft response (if available)

sent_response · string

The response that was sent (if status is sent)

client_id · string

Associated client UUID

connection_id · string

Source connection UUID

contact_id · string

Associated contact UUID

received_at · string

ISO timestamp when reply was received

handled_at · string

ISO timestamp when reply was handled (sent/archived)

created_at · string

ISO timestamp when record was created

pagination · object

Pagination metadata

Show child attributes

total · integer

Total number of matching replies

limit · integer

Number of replies per page

offset · integer

Current offset

hasMore · boolean

Whether more results exist

Examples

cURL

curl -X GET "https://app.replyify.ai/api/replies?status=pending&limit=10" \
  -H "Authorization: Bearer rpl_your_api_key"

Response Example

{
  "data": [
    {
      "id": "abc123-def456-ghi789",
      "from_email": "[e-mail]",
      "from_name": "John Smith",
      "to_email": "[e-mail]",
      "subject": "Re: Quick question about your service",
      "body_text": "Hi, I'd love to learn more about what you offer...",
      "body_html": "<p>Hi, I'd love to learn more...</p>",
      "status": "ready",
      "category_id": "cat-interested-123",
      "category": {
        "id": "cat-interested-123",
        "name": "Interested",
        "color": "#10B981"
      },
      "ai_response": "Hi John,\n\nThanks for your interest! I'd be happy to share more about...",
      "sent_response": null,
      "client_id": "client-456",
      "connection_id": "conn-789",
      "contact_id": "contact-012",
      "received_at": "2024-01-15T14:30:00Z",
      "handled_at": null,
      "created_at": "2024-01-15T14:30:05Z"
    }
  ],
  "pagination": {
    "total": 45,
    "limit": 10,
    "offset": 0,
    "hasMore": true
  }
}