GET /requests/{requestId}/messages
Basic auth

Retrieve all messages for a request, sorted by creation date (newest first).

Messages are displayed in the Messages tab of the request detail page, alongside email and SMS logs.

Path parameters

  • requestId string Required

    The ID of the request

Responses

  • 200 application/json

    List of messages for the request

    Hide response attributes Show response attributes object
    • id string

      Unique identifier for the message (format: msg_xxx)

    • requestId string

      The ID of the request this message belongs to

    • title string

      The title/subject of the message

    • text string | null

      The message content (supports markdown). Can be null if no text.

      Supports markdown formatting including bold text, italic text, headers, lists, code blocks, and links. Raw HTML is not allowed and all content is sanitized to prevent XSS attacks.

    • createdAt string(date-time)

      When the message was created (ISO 8601 format, UTC)

    • updatedAt string(date-time)

      When the message was last updated (ISO 8601 format, UTC)
  • 401

    Unauthorized -- Your API key is wrong.

  • 403

    Forbidden -- The object requested is hidden for administrators only.

  • 404

    Not Found -- The specified object could not be found.

  • 429

    Too Many Requests -- You're requesting too many objects! Slow down!

  • 500

    Internal Server Error -- We had a problem with our server. Try again later.

  • 503

    Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

GET /requests/{requestId}/messages 
curl \
 --request GET 'https://api.usecollect.com/v1/requests/{requestId}/messages' \
 --user "username:password"
Response examples (200) 
[
  {
    "id": "msg_123",
    "text": "Here is the response generated by the agent...",
    "title": "AI Agent - reply sent",
    "createdAt": "2026-01-21T10:12:46Z",
    "requestId": "req_456",
    "updatedAt": "2026-01-21T10:12:46Z"
  },
  {
    "id": "msg_124",
    "text": "All checks passed successfully.",
    "title": "Validation completed",
    "createdAt": "2026-01-21T09:30:15Z",
    "requestId": "req_456",
    "updatedAt": "2026-01-21T09:30:15Z"
  }
]