---
title: "List Whatsapp signup sessions"
method: GET
path: "/whatsapp/signup"
tags: ["Whatsapp Signup"]
---

# List Whatsapp signup sessions

`GET /whatsapp/signup`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/whatsapp/signup`
- Auth: HTTP bearer

List finished WhatsApp Embedded Signup sessions, with status `SUCCESS` or `FAILURE`, newest first. Use the `errors` of a failed session to see why provisioning stopped.

## Query parameters

- `page` object
  - `number` integer: The page number to load
  - `size` integer: The size of the page
- `filter[waba_id]` string
- `filter[customer_id]` string
- `filter[created_at][gte]` string, date-time
- `filter[created_at][lte]` string, date-time

## Response `200`

Successful response with a list of WhatsApp signup sessions

- object
  - `data` WhatsappSignupSession[]
    - `record_type` 'whatsapp_session_id'
    - `session_id` string: Signup session ID
    - `user_id` string: Telnyx user ID that owns the signup session
    - `state` 'SUBSCRIBE_WEBHOOKS' | 'ASSIGNED_USERS' | 'SHARE_CREDIT_LINE' | 'REGISTER_PHONE_NUMBER' | 'ADD_WABA_TO_DB' | 'ADD_PHONE_NUMBERS_TO_DB' | 'COMPLETE': Current provisioning step, or the step that failed. `REGISTER_PHONE_NUMBER` is skipped for coexistence signups.
    - `status` 'INCOMPLETE' | 'PENDING' | 'SUCCESS' | 'FAILURE': `INCOMPLETE` waits for the Meta signup code, `PENDING` is in progress, `SUCCESS` finished provisioning, and `FAILURE` stopped at `state`.
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `waba_id` string: Meta WhatsApp Business Account ID
    - `customer_id` string: Tech provider customer reference submitted with the signup
    - `errors` string[]: Errors recorded during provisioning
  - `meta` MessagingPaginationMeta
    - `total_pages` integer, required
    - `total_results` integer, required
    - `page_number` integer, required
    - `page_size` integer, required

## Other responses

- `4XX`: Unexpected error

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-15** `da303e40b51e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/whatsapp/signup/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)