Skip to main content
GET
Get text delivery status

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}$

Path Parameters

messageId
string
required

The messageId returned by the send endpoint.

Response

Current delivery status.

messageId
string
required
status
string
required

Carrier status: Queued, Sent, Delivered, or Rejected / Failed / Undelivered on failure.

delivered
boolean
required
failed
boolean
required
failureClassification
enum<string> | null

On failed messages: FATAL (do not retry), NON_FATAL (transient, retry may succeed), or null when the carrier reason is unrecognized.

Available options:
FATAL,
NON_FATAL

True when the failure is NON_FATAL and a retry may succeed.

createdAt
string<date-time>
updatedAt
string<date-time>