Skip to content
Anlyon
Esc
↑↓navigate↵open⌘Jpreview

List messages

Retrieve a paginated list of messages with optional filters

GET/api/v2/messages
Authorization
AuthorizationBearer token (Anlyon API key) · headerrequired

Workspace API key sent as Authorization: Bearer <key>.

or
better-auth.session_tokenAPI key · cookierequired

Browser session used by dashboard-only operations.

Query parameters
pageinteger

Page number for pagination

min 1 · default: 1
limitinteger

Number of items per page

min 1 · max 100 · default: 20
statusstring

Filter by message status

Allowed:pendingscheduledprocessingdeliveredfailedcancelled
startDatestring<date-time>

Filter messages created after this date

endDatestring<date-time>

Filter messages created before this date

urlstring

Filter by destination URL

includeEventDeliveriesboolean

Include deliveries generated by the Events fan-out system. They are hidden by default.

default: false
Header parameters
X-Request-Idstring

Optional caller correlation ID. Unsafe or oversized values are replaced.

max length 128
Responses
200

Messages retrieved successfully

successboolean
dataPublicMessage[]
Show properties
Array of PublicMessage
messageIdstringrequired
matches ^msg_
urlstring<uri>required
methodstringrequired
Allowed:GETPOSTPUTPATCHDELETE
headersobject | nullrequired

Delivery headers. Authorization, cookies, and API key values are returned as [REDACTED].

bodyany | nullrequired

Request body

scheduledForstring<date-time> | nullrequired
statusstringrequired
Allowed:pendingscheduledprocessingdeliveredfailedcancelled
attemptsinteger | nullrequired
min 0
maxRetriesinteger | nullrequired
min 0
responseStatusinteger | nullrequired
min 100 · max 599
responseBodystring | nullrequired
errorMessagestring | nullrequired
deliveredAtstring<date-time> | nullrequired
failedAtstring<date-time> | nullrequired
callbackUrlstring<uri> | nullrequired
failureCallbackUrlstring<uri> | nullrequired
flowControlKeystring | nullrequired
createdAtstring<date-time>required
updatedAtstring<date-time>required
paginationOffsetPagination
Show properties
totalintegerrequired
min 0
pageintegerrequired
min 1
limitintegerrequired
min 1
totalPagesintegerrequired
min 0
hasMorebooleanrequired
401

Unauthorized - Invalid or missing API key

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
403

Authenticated credential lacks the required scope or workspace access.

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
429

Too Many Requests - Rate limit exceeded

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.anlyon.com/api/v2/messages' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "success": true,
  "data": [
    {
      "messageId": "msg_1234567890abcdef",
      "url": "https://example.com/webhook",
      "method": "POST",
      "headers": {
        "Authorization": "[REDACTED]"
      },
      "body": {
        "event": "user_created"
      },
      "scheduledFor": null,
      "status": "delivered",
      "attempts": 1,
      "maxRetries": 3,
      "responseStatus": 204,
      "responseBody": null,
      "errorMessage": null,
      "deliveredAt": "2026-07-13T12:00:01Z",
      "failedAt": null,
      "callbackUrl": null,
      "failureCallbackUrl": null,
      "flowControlKey": null,
      "createdAt": "2026-07-13T12:00:00Z",
      "updatedAt": "2026-07-13T12:00:01Z"
    }
  ],
  "pagination": {
    "total": 0,
    "page": 1,
    "limit": 1,
    "totalPages": 0,
    "hasMore": true
  }
}