---
title: "List or filter all SMS activities"
method: GET
path: "/activity/sms/"
tags: ["activities.sms"]
---

# List or filter all SMS activities

`GET /activity/sms/`

Get a list of matching SMS activities.

MMS messages are considered SMS messages with attachments. Attachments have identical fields to email attachments (`url`, `filename`, `size` and `content_type`), a `media_id` uniquely identifying an attachment, and if Close was able to generate a thumbnail, a `thumbnail_url` too.

Accessing `url` or `thumbnail_url` requires an authenticated session and leads to a temporarily signed S3 URL.

## Query parameters

- `_limit` integer
- `_skip` integer
- `id__in` string[], nullable
- `lead_id` string[], nullable
- `contact_id` string[], nullable
- `user_id` string[], nullable
- `organization_id` string, nullable
- `_type` string[], nullable
- `date_created__gte` union
  - string, date-time
  - string, date
- `date_created__lte` union
  - string, date-time
  - string, date
- `date_created__gt` union
  - string, date-time
  - string, date
- `date_created__lt` union
  - string, date-time
  - string, date
- `activity_at__gte` union
  - string, date-time
  - string, date
- `activity_at__lte` union
  - string, date-time
  - string, date
- `activity_at__gt` union
  - string, date-time
  - string, date
- `activity_at__lt` union
  - string, date-time
  - string, date
- `_fields` string

## Response `200`

Successful response

- object
  - `data` SMSActivity[], required
    - `_type` string, required
    - `activity_at` string, date-time, nullable, required
    - `agent_action_reason` string, nullable
    - `agent_config_id` string, nullable
    - `contact_id` string, nullable, required
    - `cost` string, nullable, required
    - `created_by` string, nullable, required
    - `created_by_name` string, nullable
    - `date_created` string, date-time, required
    - `date_scheduled` string, date-time, nullable, required
    - `date_sent` string, date-time, nullable, required
    - `date_updated` string, date-time, required
    - `direction` 'inbound' | 'outbound', required — Direction of a phone activity, such as a call or an SMS message.
    - `error_message` string, nullable, required
    - `id` string, required
    - `lead_id` string, nullable, required
    - `local_country_iso` string, nullable, required
    - `local_phone` string, nullable, required
    - `local_phone_formatted` string, nullable, required
    - `organization_id` string, required
    - `remote_country_iso` string, nullable, required
    - `remote_phone` string, nullable, required
    - `remote_phone_formatted` string, nullable, required
    - `sequence_id` string, nullable
    - `sequence_name` string, nullable
    - `sequence_subscription_id` string, nullable
    - `source` 'Close.io' | 'External', required — Source of a phone activity. Describes whether the phone activity (such as a call or an SMS) was handled by Close's telephony provider or handled externally by a 3rd party and is merely logged in Close.
    - `status` 'inbox' | 'draft' | 'scheduled' | 'outbox' | 'sent' | 'error', required — Status of a message, such as Email or SMS.
    - `template_id` string, nullable, required
    - `text` string, nullable, required
    - `updated_by` string, nullable, required
    - `updated_by_name` string, nullable
    - `user_id` string, nullable, required
    - `user_name` string, nullable
    - `users` string[], required
  - `has_more` boolean, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)