---
title: "Toll-free numbers Banger can buy for this workspace, which text phones in the US and Canada. Needs the customers workspace feature and a paid plan."
method: GET
path: "/v1/workspaces/{workspaceId}/mailboxes/sms/available-numbers"
---

# Toll-free numbers Banger can buy for this workspace, which text phones in the US and Canada. Needs the customers workspace feature and a paid plan.

`GET /v1/workspaces/{workspaceId}/mailboxes/sms/available-numbers`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/mailboxes/sms/available-numbers`
- Auth: HTTP bearer

## Response `200`

Numbers to pick from.

- object
  - `data` object[], required
    - `phone_number` string, required
    - `kind` 'toll_free', required
    - `reaches` string[], required

## Other responses

- `402`: A number from Banger comes with a paid plan.
- `503`: Numbers from Banger aren't available yet.

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)