Skip to main content
GET
List text messages

Authorizations

collectwise_key
string
header
required

Active, unexpired API key belonging to an active organization. Optional organization/key signing and organization IP restrictions also apply; see API Access.

Headers

x-cw-timestamp
string

Required together with x-cw-signature when signing is enabled for this key or organization. POST /security/verify also requires signing whenever a usable secret exists. Canonical Unix seconds, within ±300 seconds. See API Access for CW1 signing.

Pattern: ^(0|[1-9][0-9]*)$
x-cw-signature
string

CW1 HMAC-SHA256 signature: v1= followed by 64 lowercase hex digits. Use the decoded 32-byte signing secret and exact request bytes. See API Access.

Pattern: ^v1=[0-9a-f]{64}$

Query Parameters

messageId
string

A messageId returned by the send endpoint. Returns that message's whole thread, in both directions. 404 if the id does not belong to your organization.

debtorId
string

Your reference for the recipient, as sent on debtorId.

destination
string

Recipient phone number, in any of the formats the send endpoint accepts.

limit
integer
default:50

Maximum number of messages to return.

Required range: 1 <= x <= 200
since
string<date-time>

ISO 8601 timestamp. Returns only messages created at or after it. Valid on its own, so you can use it to backfill everything your organization received after a webhook outage.

Response

Matching messages, newest first.

count
integer
required
messages
object[]
required