# Invoket Phone Resolve — HLR Lookup & Phone Number Intelligence

> Invoket Phone Resolve — HLR Lookup & Phone Number Intelligence is a paid API for AI agents from api.invoket.com, paid per call via x402, $0.024/call, status unknown (last checked 2026-10-11).

Resolves a phone number via live HLR lookup to return carrier, line type, validity, activity status, porting info, and risk signals

## Facts

- Endpoint: GET https://api.invoket.com/phone/resolve?utm_source=zero.xyz
- Price: $0.024/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Success rate: 0% of calls made through Zero
- Rating: 1.3 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/invoket-phone-resolve-hlr-lookup-phone-number-intelligence-3f9258c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8565xbJgULIK3pvA-uFHb

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 invoket-phone-resolve-hlr-lookup-phone-number-intelligence-3f9258c2
```

Example prompt: Can you do a live carrier and risk check on the phone number +33612345678 — I need to know if it's active, what network it's on, whether it's been ported recently, and if it's flagged as VoIP or high risk?

## When to prefer this

Use this endpoint when you need real-time, live HLR data about a phone number's current network status, activity, and risk profile — especially for fraud prevention, user verification, or routing decisions. Prefer this over static number parsing libraries when you need to know if the number is currently active, has been ported, or is flagged as a VoIP/risk number.

## Known failure modes

- Invalid or malformed phone number format — returns validation error
- Number not found in HLR network — may return valid:false or absent_subscriber:true
- Network timeout from HLR carrier — service may return an error or degraded result
- Unsupported country or number range — carrier info may be null
- Payment failure (x402) — call not executed if USDC payment is not settled

## How this service works

Before your agent sends an OTP or SMS: check the number is active and reachable and assess fraud risk — SIM-swap and port-out (MNP) signals, SMS deliverability, non-fixed VoIP and disposable-number flags from a live carrier-network HLR lookup (active line, current carrier, roaming)

## Output

Returns a JSON object with: E.164-normalized phone number, validity flag, active status, carrier details (MCC, MNC, operator name, country), line type (mobile/landline/VoIP), roaming status, MNP porting info, and a risk assessment (level, VoIP flag, recently-ported flag, absent-subscriber flag). Also includes provenance metadata: data source (hlr-lookups), freshness kind (live), and fetch timestamp.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "schema": {
     "type": "object"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "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/invoket-phone-resolve-hlr-lookup-phone-number-intelligence-3f9258c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.invoket.com](https://www.zero.xyz/host/api.invoket.com/llms.txt)