# ContinuationPagedResultDtoOfSmsLogDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Represents a page of results obtained through continuation-token paging.
Supports an approximate total count for display purposes.

## Fields
- `items` (array<[SmsLogDto](https://devportal.demo.winkpg.io/docs/api/models/SmsLogDto.md)>): The items returned for this page. (nullable)
  Fields of each item:
  - `id` (string(uuid))
  - `correlationId` (string(uuid)): The platform correlation id for this message. Equal to `id`: there is  exactly one row per outbound message, so the correlation id is the document key. Surfaced under  its own name because that is what callers of the send API hold.
  - `toPhoneNumberMasked` (string): Recipient reduced to its last four digits (for example `•••••••4567`). (nullable)
  - `fromPhoneNumberMasked` (string): Sending number reduced to its last four digits, when the send used a from-number. (nullable)
  - `messagingServiceSid` (string): The Messaging Service SID the send routed through, when one was configured. (nullable)
  - `messageSid` (string): Twilio's message SID, once the API accepted the message. Null for blocked / failed sends. (nullable)
  - `status` ([SmsDeliveryStatus](https://devportal.demo.winkpg.io/docs/api/models/SmsDeliveryStatus.md)): Where the message currently sits in its lifecycle.
    Values:
    - `Unknown`: No state recorded. Only ever seen on a malformed document.
    - `GatewayBlocked`: The send-time compliance gate refused the message (for example the recipient has opted out). No Twilio API call was made, so no carrier callback will ever follow. Distinct from GatewaySendFailed so a compliance block is auditable separately from a carrier fault.
    - `GatewaySendFailed`: The Twilio API rejected the create-message call. The message never entered the carrier network.
    - `GatewaySent`: Twilio accepted the message. Carrier callbacks (if a status callback URL was set) follow.
    - `Queued`: Carrier callback: the message is queued, accepted, scheduled, or sending.
    - `Sent`: Carrier callback: the message has been handed to the carrier.
    - `Delivered`: Carrier callback: the carrier confirmed delivery to the handset.
    - `Undelivered`: Carrier callback: the carrier could not deliver the message. Usually carries a Twilio error code.
    - `Failed`: Carrier callback: the message failed outright or was cancelled. Usually carries a Twilio error code.
  - `isFailure` (boolean): Whether `status` means the message did not reach the handset.
  - `twilioErrorCode` (integer(int32)): Twilio numeric error code from the failing send or callback, when one was reported. (nullable)
  - `failureCode` (string): Platform error code explaining a gateway-side refusal (for example a compliance block). (nullable)
  - `bodyLength` (integer(int32)): Message length in characters. The body itself is never stored or returned. (nullable)
  - `category` ([SmsMessageCategory](https://devportal.demo.winkpg.io/docs/api/models/SmsMessageCategory.md)): Declared message category.
    Values:
    - `Transactional`: Transactional message tied to a specific interaction the recipient initiated or expects (payment link, receipt, invoice, one-time passcode). This is the platform's default when a caller sets no category: every SMS sender wired today is transactional.
    - `Marketing`: Promotional / marketing message. Requires express marketing consent and is subject to the stricter content and timing policy. Callers sending marketing SMS must set this explicitly; it is never inferred.
    - `Reminder`: Recurring reminder in an ongoing program the recipient enrolled in (an overdue-invoice reminder series, a scheduled payment nudge). Not marketing, but recurring, so CTIA requires the opt-out instruction to ride on the message itself and TCPA timing applies.
  - `timestamp` (string(date-time)): When the send was attempted (UTC).
  - `lastStatusAt` (string(date-time)): When the most recent carrier callback was applied (UTC). Null until the first one lands. (nullable)
  - `tenantId` (string(uuid)): Tenant the message was sent under. (nullable)
  - `merchantId` (string(uuid)): Merchant the message belongs to. (nullable)
- `nextContinuationToken` (string): Continuation token to use when requesting the next page.  Null means no additional pages exist. (nullable)
- `approxTotalCount` (integer(int64)): An approximate total count of matching items.  This value is optional and may be stale or estimated, so treat it as an approximation. (nullable)
- `pageItemCount` (integer(int32)): Convenience property for the number of items in this page. (read only)
- `retrievedAt` (string(date-time)): When the page was retrieved. Useful for diagnostics and cache behavior.

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.