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

# Find local numbers

`GET /numbers/local`

Searches for numbers available for purchase in CallFire local numbers catalog . At least one additional parameter is required. User may filter local numbers by their region information. If all numbers with desirable zip code is already busy search will return available numbers with nearest zip code.

## Query parameters

- `limit` integer
- `prefix` string
- `city` string
- `state` string
- `zipcode` string
- `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)