---
title: "Returns SMS conversations based on the given filter criteria"
method: GET
path: "/sms"
tags: ["sms"]
---

# Returns SMS conversations based on the given filter criteria

`GET /sms`

Retrieves SMS conversation threads including message history between tracking numbers and contacts. Returns conversations with message content, timestamps, participant information, and delivery status. Supports pagination and filtering.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string[]

## Response `200`

SMS conversations with message history and metadata

- Getsms
  - `conversation_id` integer — The unique identifier for the conversation. Type: integer (int32).
  - `campaign_id` integer — Unique identifier for the campaign this call was attributed to. Integer.
  - `group_id` integer — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.
  - `tracking_number` string — Phone number the caller dialed (the tracking/DNI number). Convirza routes calls from this number through the configured call flow. String of digits.
  - `caller_id` string — Phone number of the originating caller. String of digits, typically 10 digits for US numbers (e.g., '2025550123').
  - `conversation_started` string, date-time — The date and time that the conversation was started. Type: string (date-time).
  - `message` string — SMS message body. String. Max length set by carrier (typically 160 chars for single-segment, up to 1600 for concatenated).
  - `conversation_status` string — Indicates the current status of the conversation. Type: string.
  - `pin` boolean — Indicates whether the pin is required or not. Type: boolean.
  - `agent_id` integer — The unique identifier for the agent assigned to the conversation. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)