# List numbers

`GET /v1/numbers`

Returns your workspace's WhatsApp numbers. The default number comes first.

Needs `numbers:read`.

## No paging

The list isn't paged, so `next_cursor` is always `null`. Tokens and other credentials are never included.

## Example

```sh
curl https://app.soosh.io/v1/numbers \
  -H "Authorization: Bearer $SOOSH_API_KEY"
```

Response 200:

```json
{
  "data": [
    {
      "id": "0f6d3c1e-5b7a-4c52-9a55-3f6a2d5c8b10",
      "name": "Sales",
      "phone": "+912212345678",
      "display_name": "Blue Lotus Fashion",
      "verified_name": "Blue Lotus Fashion Pvt Ltd",
      "status": "active",
      "is_default": true
    }
  ],
  "next_cursor": null
}
```

## Returns

200. Your workspace's numbers.