List all WhatsApp numbers

curl https://api.muchaw.dev/api/numbers/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "wabaId": "123456789012345",
      "phoneNumberId": "987654321098765",
      "displayNumber": "+14155552671",
      "qualityRating": "GREEN",
      "verifiedName": "Acme Corp",
      "nameStatus": "APPROVED",
      "messagingLimitTier": "TIER_10K",
      "accountMode": "LIVE",
      "isOfficialBusinessAccount": true,
      "codeVerificationStatus": "VERIFIED",
      "status": "ACTIVE",
      "tokenExpiresAt": "2024-07-01T12:00:00Z",
      "createdAt": "2023-11-15T09:30:00Z",
      "updatedAt": "2024-04-20T16:45:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 1,
    "offset": 0
  }
}

Returns a paginated list of WhatsApp numbers connected to your account via Embedded Signup. Optionally filter by connection status.

Authentication

AuthorizationBearer

API Key in the format mk_live_<43-chars>. Obtain from the Dashboard or POST /auth/api-keys.

Query parameters

statusenumOptional

Filter numbers by connection status

Allowed values:

limitintegerOptional1-100Defaults to 20

Maximum number of records to return per page

offsetintegerOptional0-9007199254740991Defaults to 0

Number of records to skip for pagination

Response

Default Response

datalist of objects

List of WhatsApp numbers

paginationobject

Pagination metadata

Errors

401

Unauthorized Error