# NumberIntel Carrier Lookup

> NumberIntel Carrier Lookup is a paid API for AI agents from numberintel.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-18).

Returns carrier of record, line type (mobile/landline/VoIP/pager), in-service possibility, rate center, and risk hints for any US or US-territory phone number using NANPA block-level data.

## Facts

- Endpoint: GET https://numberintel.dev/v1/carrier?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/numberintel-carrier-lookup-b525694d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5uAaBzYmiISFBWkKu0WnY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability numberintel-carrier-lookup-b525694d
```

Example prompt: Can you look up what carrier and line type is associated with the phone number +14155551234 — I want to know if it's a mobile, landline, or VoIP number and whether it can actually be in service?

## When to prefer this

Choose this endpoint when you need block-level NANPA carrier and line type data for US numbers and do not require real-time HLR/MNP porting data. It is ideal for pre-campaign scrubbing, fraud screening at signup, and enriching contact records where the original carrier assignment is sufficient. Prefer this over bulk endpoints when checking individual numbers on demand. Use the bulk sibling endpoint if you need to scrub large lists efficiently.

## Known failure modes

- Non-US or non-NANPA number submitted — endpoint only covers US and US-territory numbers
- Invalid or unparseable phone number format — returns error if number cannot be normalized
- Number in an unallocated or unassigned NANPA block — in-service flag will indicate cannot be in service
- Rate limiting or payment failure — 402 response if USDC payment not properly attached
- Ported numbers return original block-level carrier, not current carrier — may not reflect post-port carrier

## How this service works

US phone carrier lookup: carrier of record, line type (mobile / landline / VoIP / pager), whether the number can be in service at all, rate center and risk hints for any US or US-territory number. NANPA public numbering data refreshed weekly; block-level, so ported numbers keep their original carrier.

## Output

Returns the carrier of record (the original block owner, not necessarily the current carrier for ported numbers), line type classification (mobile, landline, VoIP, or pager), a flag indicating whether the number is plausibly in service, the NANPA rate center, and risk hints — all derived from weekly-refreshed NANPA block-level data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "number"
     ],
     "properties": {
      "number": {
       "type": "string",
       "description": "Phone number, any common format (E.164 preferred)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/numberintel-carrier-lookup-b525694d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from numberintel.dev](https://www.zero.xyz/host/numberintel.dev/llms.txt)