Get WABA Number

Retrieve the full details of a single WhatsApp Business API (WABA) number connected to your account by its UUID.

info

Requires a WhatsApp Business API (WABA) channel connected to your 2Chat account. See How to connect WABA to 2Chat.

Endpoint

GET https://api.p.2chat.io/open/waba/numbers/{waba_uuid}

Authentication

Include your API key in the X-User-API-Key header. Learn more about authentication.

Path parameters

Parameter	Description	Example
`waba_uuid`	The UUID of the WABA number to retrieve.	`WAN3ff9fb72-6ecd-4c2a-9055-4836d8ed33d7`

Invocation

cURL
Python
JavaScript

curl --request GET \
  --url 'https://api.p.2chat.io/open/waba/numbers/WAN3ff9fb72-6ecd-4c2a-9055-4836d8ed33d7' \
  --header 'Content-Type: application/json' \
  --header 'X-User-API-Key: your_api_key_here'

import requests

url = "https://api.p.2chat.io/open/waba/numbers/WAN3ff9fb72-6ecd-4c2a-9055-4836d8ed33d7"
headers = {
  "Content-Type": "application/json",
  "X-User-API-Key": "your_api_key_here"
}

response = requests.get(url, headers=headers)
print(response.json())

const axios = require('axios');

axios.get('https://api.p.2chat.io/open/waba/numbers/WAN3ff9fb72-6ecd-4c2a-9055-4836d8ed33d7', {
  headers: {
    'Content-Type': 'application/json',
    'X-User-API-Key': 'your_api_key_here'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

Response

Success (HTTP 200 OK)

{
  "success": true,
  "number": {
    "uuid": "WAN3ff9fb72-6ecd-4c2a-9055-4836d8ed33d7",
    "account_uuid": "ACT7a2c1d84-3b5e-4f91-a012-8c3d7e5f2b19",
    "business_id": "1234567890",
    "friendly_name": "My WABA Number",
    "iso_country_code": "US",
    "verified_name": "My Business",
    "phone_number": "+16173518454",
    "formatted_phone_number": "+1 617-351-8454",
    "phone_number_id": "109876543210",
    "channel_type": "whatsapp",
    "connection_status": "C",
    "enabled": true,
    "pushname": "My Business",
    "business_calling_enabled": false,
    "messaging_provider": "meta",
    "is_coexistence": false,
    "meta_waba_id": "9876543210123",
    "is_only_for_calls": false,
    "has_meta_token": true,
    "created_at": "2025-11-19 23:04:18",
    "updated_at": "2026-02-02 19:41:12"
  }
}

Field	Description
`success`	`true` when the request succeeded
`number.uuid`	WABA number UUID
`number.account_uuid`	UUID of the account this number belongs to
`number.business_id`	Business ID from the messaging provider
`number.friendly_name`	Display name set for this number
`number.iso_country_code`	Two-letter country code (e.g. `US`)
`number.verified_name`	Business name verified by Meta
`number.phone_number`	Phone number in E.164 format
`number.formatted_phone_number`	Human-readable formatted phone number
`number.phone_number_id`	Phone number ID assigned by Meta
`number.channel_type`	Always `whatsapp` for WABA numbers
`number.connection_status`	Connection status (`C` = connected)
`number.enabled`	Always `true` for WABA numbers
`number.pushname`	Display name shown in WhatsApp
`number.business_calling_enabled`	Whether WhatsApp Business Calling is enabled
`number.messaging_provider`	Messaging provider (`meta` or `gupshup`)
`number.is_coexistence`	Whether the number uses Meta coexistence mode
`number.meta_waba_id`	Meta WABA account ID
`number.is_only_for_calls`	`true` if the number is restricted to calls only
`number.has_meta_token`	`true` if a Meta access token is configured
`number.created_at`	Creation timestamp
`number.updated_at`	Last update timestamp

Error

{
  "error": true,
  "error_message": "Description of what went wrong"
}

Field	Description
`error`	`true` when the request failed
`error_message`	A description of what went wrong

Get WABA Number

Endpoint​

Authentication​

Path parameters​

Invocation​

Response​

Success (HTTP 200 OK)​

Error​