TextMessageBatchSubmissionResponse

The 202 submission response: the batch summary, one pre-created message per created recipient, and the rejected entries.

text_messages keeps submission order, with one cutover exception: A batch that was partly processed when Resia moved to per-item IDs (2026-08-25) can order its items differently — match items by to_phone_number or client_reference. rejected_text_messages lists every submitted recipient Resia did not create, each with its 0-based submission position. text_messages and rejected_text_messages together account for every submitted recipient. A repeated Idempotency-Key returns the same batch again — the same batch ID, the same text_message_id values, and the same recipients reported as rejected.

  • counts
    Type: TextMessageBatchCounts
    required

    How the batch's recipients are distributed across states right now.

    Properties: 6
  • created_at
    Type: stringFormat: date-time
    required

    When Resia accepted the batch.

  • from_phone_number
    Type: string
    required

    The sender number every message in the batch texts from.

  • id
    Type: string
    min length:  
    1
    max length:  
    512
    required

    Identifier of the batch.

  • status
    Type: BatchStatusenum
    required

    The batch's derived lifecycle state.

    values
    in_progresscompletedcanceled
  • total
    Type: integer
    min:  
    0
    required

    How many recipients the batch created. Equal to the submitted count minus the rejected entries; zero when every recipient was rejected.

  • completed_at
    Type: stringFormat: date-timenullable

    When the batch reached a terminal state, or null while it is still in progress.

  • rejected_text_messages
    Type: array of BatchRejectedEntry …1000

    Every submitted recipient Resia did not create, each with its 0-based submission position and the reason. Empty when every recipient was created.

    Properties: 4
  • text_messages
    Type: array of TextMessageBatchItem …1000

    One item per created recipient, in submission order (one cutover exception — see TextMessageBatchItemPage), each with its final text_message_id. Empty when every submitted recipient was rejected.

    Properties: 5