---
title: "List SMS"
method: GET
path: "/v1/design_studio/sms"
tags: ["SMS"]
---

# List SMS

`GET /v1/design_studio/sms`

## Request

- Base URL: `https://api.customer.io`
- URL: `https://api.customer.io/v1/design_studio/sms`
- Auth: none declared

Returns a paginated list of your SMS messages and a separate array of the folders they belong to. Each item in the list is a summary; to see an SMS's content, recipient, and sender, [get the SMS](/integrations/api/design-studio/tag/sms/getSms/).

## Query parameters

- `page` integer
- `limit` integer
- `parent_folder_id` string, uuid
- `direct_descendants_only` boolean
- `sort_by` 'created' | 'updated' | 'name'
- `sort_order` 'asc' | 'desc'
- `created_before` integer
- `created_after` integer
- `updated_before` integer
- `updated_after` integer

## Response `200`

Successful response

- object
  - `sms` object[]
    - `id` string, uuid: The UUID of the SMS.
    - `name` string: The friendly name your team sees for the SMS in Design Studio.
    - `is_linked` boolean: Whether you've linked the SMS to a workflow, like a transactional message, a one-time send, or an automation action.
    - `parent_folder_id` string, uuid, nullable: UUID of the folder that contains the SMS, or `null` if the SMS is at the root level.
    - `created` integer: When you created the SMS, as a Unix timestamp in seconds.
    - `updated` integer: When the SMS last changed, as a Unix timestamp in seconds.
  - `folders` Folder[]
    - `id` string, uuid: ID of folder
    - `name` string: The name of the folder.
    - `parent_folder_id` string, uuid, nullable: The ID of the parent folder. Returns `null` if there is no parent, which means the folder is in the root directory.
    - `created` integer: Timestamp of when the folder was created.
    - `updated` integer: Timestamp of last update to the folder.
  - `meta` ListMeta
    - `pagination` object
      - `page` integer: The page number of results you're on.
      - `limit` integer: The number of results per page.
      - `total` integer: The total number of folders.
    - `filters` object: The filters applied in your request.

## Other responses

- `400`: The request is invalid due to malformed parameters, missing required fields, or constraint violations.
- `401`: Authentication failed due to a missing or invalid API key.
- `404`: The requested resource was not found.

## Changes

- **2026-10-08** `6378ded43e43`: 2 info
  - api tag `SMS` added
  - api tag `Design Studio SMS` removed
- **2026-10-06** `b0a0db5fbc21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/design_studio/sms/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) - [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/revisions/ac0b282053fe?raw)