Workspace
The workspace your API key belongs to, and its connected channels.
Inspect the current API key
Section titled “Inspect the current API key”GET
/v1/meAvailableReturns the workspace, environment and scopes of the key used for the request. Handy as a first “is my key working?” call.
curl "https://api.waasl.io/v1/me" \ -H "Authorization: Bearer $WAASL_API_KEY"const res = await fetch("https://api.waasl.io/v1/me", { headers: { Authorization: `Bearer ${process.env.WAASL_API_KEY}` },});if (!res.ok) throw new Error((await res.json()).code);const data = await res.json();import osimport requests
r = requests.get( "https://api.waasl.io/v1/me", headers={"Authorization": f"Bearer {os.environ['WAASL_API_KEY']}"},)r.raise_for_status()print(r.json())Response 200 — Key information
{ "workspace_id": "ws_26N2SaWtMR", "workspace_name": "Diet Station", "environment": "live", "key_prefix": "wsl_live_8fK2", "scopes": [ "contacts:read", "contacts:write", "messages:write" ]}Errors: 401 Missing, invalid or revoked API key
Retrieve the workspace
Section titled “Retrieve the workspace”GET
/v1/workspaceAvailablecurl "https://api.waasl.io/v1/workspace" \ -H "Authorization: Bearer $WAASL_API_KEY"const res = await fetch("https://api.waasl.io/v1/workspace", { headers: { Authorization: `Bearer ${process.env.WAASL_API_KEY}` },});if (!res.ok) throw new Error((await res.json()).code);const data = await res.json();import osimport requests
r = requests.get( "https://api.waasl.io/v1/workspace", headers={"Authorization": f"Bearer {os.environ['WAASL_API_KEY']}"},)r.raise_for_status()print(r.json())Response 200 — The workspace
{ "id": "ws_26N2SaWtMR", "name": "Diet Station", "industry": "food", "country": "KW", "timezone": "Asia/Kuwait", "language": "ar", "plan": "starter"}Errors: 401 Missing, invalid or revoked API key
List channels
Section titled “List channels”GET
/v1/channelsAvailableEvery connected channel in the workspace. Today WhatsApp Business (Cloud API) is live; Instagram, Messenger, SMS, email and web chat are coming soon and will appear here with the same shape.
curl "https://api.waasl.io/v1/channels" \ -H "Authorization: Bearer $WAASL_API_KEY"const res = await fetch("https://api.waasl.io/v1/channels", { headers: { Authorization: `Bearer ${process.env.WAASL_API_KEY}` },});if (!res.ok) throw new Error((await res.json()).code);const data = await res.json();import osimport requests
r = requests.get( "https://api.waasl.io/v1/channels", headers={"Authorization": f"Bearer {os.environ['WAASL_API_KEY']}"},)r.raise_for_status()print(r.json())Response 200 — Channels
{ "data": [ { "id": "ch_wa_7Yt2", "type": "whatsapp", "status": "connected", "name": "Diet Station", "display_phone": "+965 2200 1234", "verified_name": "string", "quality": "GREEN", "waba_id": "string", "phone_number_id": "string", "created_at": "2026-10-01T08:15:00Z" } ]}Errors: 401 Missing, invalid or revoked API key
Retrieve a channel
Section titled “Retrieve a channel”GET
/v1/channels/{channel_id}BetaPath parameters
| Field | Type | Description |
|---|---|---|
channel_id required |
string |
curl "https://api.waasl.io/v1/channels/ch_wa_7Yt2" \ -H "Authorization: Bearer $WAASL_API_KEY"const res = await fetch("https://api.waasl.io/v1/channels/ch_wa_7Yt2", { headers: { Authorization: `Bearer ${process.env.WAASL_API_KEY}` },});if (!res.ok) throw new Error((await res.json()).code);const data = await res.json();import osimport requests
r = requests.get( "https://api.waasl.io/v1/channels/ch_wa_7Yt2", headers={"Authorization": f"Bearer {os.environ['WAASL_API_KEY']}"},)r.raise_for_status()print(r.json())Response 200 — The channel
{ "id": "ch_wa_7Yt2", "type": "whatsapp", "status": "connected", "name": "Diet Station", "display_phone": "+965 2200 1234", "verified_name": "string", "quality": "GREEN", "waba_id": "string", "phone_number_id": "string", "created_at": "2026-10-01T08:15:00Z"}Errors: 404 Not found in this workspace