---
title: "Get Whatsapp signup session status"
method: GET
path: "/whatsapp/signup/{id}/status"
tags: ["Whatsapp Signup"]
---

# Get Whatsapp signup session status

`GET /whatsapp/signup/{id}/status`

## Request

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

Retrieve the current state and status of a WhatsApp Embedded Signup session.

## Path parameters

- `id` string, required

## Response `200`

Successful response with a WhatsApp signup session

- 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

## Other responses

- `404`: Signup session not found
- `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/:id/status/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)