---
title: "Find tollfree numbers"
method: GET
path: "/numbers/tollfree"
tags: ["numbers"]
---

# Find tollfree numbers

`GET /numbers/tollfree`

Searches for the toll free numbers which are available for purchase in the CallFire catalog

## Query parameters

- `pattern` string
- `limit` integer
- `fields` string

## Response `200`

successful operation

- NumberList — ~
  - `items` object[] — ~
    - `number` string — ~
    - `sendEmailOnCreate` boolean — ~
    - `nationalFormat` string — ~
    - `tollFree` boolean — ~
    - `region` Region — Every local number associated with a region. You can query regions to use them in subsequent purchase requests
      - `prefix` string — A country prefix of a region. 4-7 digit
      - `city` string — A city of a region
      - `state` string — A two-letter state code of region
      - `zipcode` string — A five-digit zip code of a region
      - `regionCode` string — ~
      - `population` integer — ~
      - `country` string — A country of a region
      - `latitude` number, float — A latitude of a region
      - `longitude` number, float — A longitude of a region
      - `timeZone` string — A timezone of a region

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.net/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/versions/9f6fb501bc03/schema)