---
title: "Lookup numbers"
method: POST
path: "/fonenumbers/lookup"
tags: ["FoneNumbers", "fonenumbers"]
---

# Lookup numbers

`POST /fonenumbers/lookup`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/fonenumbers/lookup`
- Auth: API key in header `token`

API to lookup number information.

## Request body

- object
  - `numbers` string[], required: Array of Valid 10 digit numbers

## Response `200`

Success

- object
  - `numbers` NumberLookup[]
    - `number` string: Number
    - `type` string: Number type
    - `lrn` string: Location Routing Number the number is currently ported to
    - `owner_id` string: OCN or RESPORG
    - `spid` string: Service Provider ID
    - `itg` string: Whether the number is an intermediate/tandem gateway number - 'yes' or 'no'
    - `valid` string: Whether the number is valid - 'yes' or 'no'
    - `fractel_status` string: FracTEL assignment status of the number
    - `npanxx` string: NPA-NXX (area code and exchange) of the number
    - `state` string: US State for the number
    - `company` string: Carrier/company associated with the number
    - `ocn` string: Operating Company Number
    - `ratecenter` string: Rate center for the number
    - `clli` string: Common Language Location Identifier for the switch
    - `assigndate` string: Date the number was assigned
    - `prefixtype` string: Prefix type - e.g. 'CLEC', 'ILEC'
    - `switchname` string: Switch name, when available
    - `switchtype` string: Switch type, when available
    - `lata` string: Local Access and Transport Area
    - `ilecname` string: Incumbent Local Exchange Carrier name, when available
    - `ilecocn` string: Incumbent Local Exchange Carrier Operating Company Number
    - `country` string: Country code

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)