---
title: "List Whatsapp hosted signups"
method: GET
path: "/whatsapp/hosted_signups"
tags: ["Whatsapp Signup"]
---

# List Whatsapp hosted signups

`GET /whatsapp/hosted_signups`

## Request

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

List hosted signups created by the account, newest first. Expired hosted signups are included.

## Query parameters

- `page` object
  - `number` integer: The page number to load
  - `size` integer: The size of the page

## Response `200`

Successful response with a list of WhatsApp hosted signups

- object
  - `data` WhatsappHostedSignup[]
    - `id` string: Hosted signup ID
    - `record_type` 'whatsapp_jwt'
    - `app_id` string: Meta App ID the hosted signup onboards customers into
    - `solution_id` string: Meta Partner Solution ID linked to the app. Returned only when creating a hosted signup.
    - `created_at` string, date-time
    - `expires_at` string, date-time: When the onboarding URL stops working
    - `jwt` string: Signed token embedded in `url`
    - `url` string, uri: Hosted onboarding URL to share with the end customer
  - `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-16** `9a5085a4f2ab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/whatsapp/hosted_signups/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)