List your text message batches

​

Returns your organization's text message batches, newest first, one page at a time. Follow next_cursor for the next page. Each item is the same whole-batch progress the single-batch read returns.

Query Parameters

  • The next_cursor from the previous page. Omit it for the first page.

  • How many batches to return per page.

  • Only return records whose tags hold this key with exactly tag_value. Send it together with tag_value. Because it travels in the URL, it must not carry names, phone numbers, or any personal, health, credential, or secret information.

  • The value tag_key must hold. Send it together with tag_key. Because it travels in the URL, it must not carry names, phone numbers, or any personal, health, credential, or secret information.

Headers

  • For Resia staff only. Omit it: your key acts on your own organization.

Responses

  • application/json
  • application/json
Request Example for get/v1/text-message-batches
curl 'https://api.resia.ai/v1/text-message-batches?limit=50' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "items": [
    {
      "id": "01M0C7XKQ3ZT9V4W8N2RGA5HDB",
      "status": "in_progress",
      "from_phone_number": "string",
      "total": 0,
      "counts": {
        "queued": 0,
        "canceled": 0,
        "sent": 0,
        "delivered": 0,
        "delivery_unconfirmed": 0,
        "failed": 0
      },
      "created_at": "2026-11-20T21:45:15.453Z",
      "completed_at": "2026-11-20T21:45:15.453Z",
      "tags": {
        "additionalProperty": "string"
      }
    }
  ],
  "next_cursor": "string"
}