# Numbers Online Phone Intelligence API

**Canonical:** https://apis.io/apis/numbers-online/numbers-online-phone-intelligence-api/  
**Provider:** Numbers Online — https://apis.io/providers/numbers-online/  
**Base URL:** https://numbers.online  
**Documentation:** https://numbers.online/docs

Numbers Online Phone Intelligence API is one of 3 APIs that [Numbers Online](https://apis.io/providers/numbers-online/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Phone Intelligence, Caller ID, CNAM, Do Not Call, and Telephony. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

One REST API over a single E.164 primitive: parse and validate numbers, single and bulk lookup (line type, range carrier, CNAM, STIR/SHAKEN verstat and a supplementary spam signal), signed inbound caller intelligence with single-use receipts, outbound pre-call do-not-contact scrub and call-provenance enrollment, consent-first list scrubbing, prepaid accounts and key lifecycle, a ClearIP-compatible SBC/SIP redirect decision, operator HMAC signing, a signed FCC robocall-mitigation evidence bundle, and a multi-tenant MSP control plane. Keys are self-service (POST /api/v1/account/signup), sent as X-API-Key or Authorization: Bearer; the free tier is rate-limited and unbilled, the standard tier is prepaid per dip.

## Operations (56)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/parse` | Parse a phone number |
| POST | `/api/v1/parse/batch` | Parse multiple phone numbers |
| POST | `/api/v1/scrub` | Scrub a calling list |
| GET | `/api/v1/countries` | List supported countries |
| GET | `/api/v1/lookup/{e164}` | Look up a single number |
| POST | `/api/v1/lookup/batch` | Look up multiple numbers |
| GET | `/api/v1/lookup/changes` | Reputation-change feed |
| POST | `/api/v1/inbound/lookup` | Inbound caller lookup |
| POST | `/api/v1/outbound/lookup` | Outbound pre-call check (scrub + provenance) |
| POST | `/api/v1/outbound/enroll` | Enroll a number for call-provenance |
| POST | `/api/v1/precall/lookup` | Outbound pre-call check — original spelling (permanent alias) |
| POST | `/api/v1/precall/enroll` | Enroll a number — original spelling (permanent alias) |
| GET | `/api/v1/cid/{number}` | Plain-text caller-id lookup |
| GET | `/api/v1/cid` | Plain-text caller-id (zero-segment fallback) |
| POST | `/api/v1/account/signup` | Sign up for an API key |
| GET | `/api/v1/account` | Get account balance and usage |
| PATCH | `/api/v1/account` | Update account name / reminder email |
| GET | `/api/v1/account/listings/{e164}` | Onboarding state + live trust for an account-owned number |
| PUT | `/api/v1/account/listings/{e164}` | Stage a draft profile (or edit a live listing) |
| POST | `/api/v1/account/listings/{e164}/verify-checkout` | Mint a verification payment link |
| POST | `/api/v1/account/listings/{e164}/logo` | Upload a business logo |
| POST | `/api/v1/account/listings/{e164}/documents` | Upload a verification document |
| GET | `/api/v1/account/listings/{e164}/reports` | Reports + reviews filed against an owned number |
| POST | `/api/v1/account/topup` | Add prepaid credit |
| GET | `/api/v1/account/keys` | List API keys |
| POST | `/api/v1/account/keys` | Mint a new API key |
| GET | `/api/v1/account/keys/{id}` | Read one API key |
| PATCH | `/api/v1/account/keys/{id}` | Rename or disable an API key |
| POST | `/api/v1/account/keys/{id}/rotate` | Rotate an API key in place |
| GET | `/api/v1/account/phones` | List your verified numbers (enrollment inventory) |
| PATCH | `/api/v1/account/phones/{e164}` | Enroll / revoke call-provenance (resource form) |
| POST | `/api/v1/account/verify-phone/start` | Verify a business number (step 1: send code) |
| POST | `/api/v1/account/verify-phone/confirm` | Verify a business number (step 2: confirm code) |
| GET | `/api/v1/account/tenants` | List tenants |
| POST | `/api/v1/account/tenants` | Create a tenant |
| GET | `/api/v1/account/tenants/{id}` | Get tenant detail |
| PATCH | `/api/v1/account/tenants/{id}` | Set tenant status |
| POST | `/api/v1/account/tenants/{id}/keys` | Issue a tenant sub-key |
| GET | `/api/v1/account/tenants/{id}/suppressions` | List tenant suppressions |
| POST | `/api/v1/account/tenants/{id}/suppressions` | Add a suppression |
| DELETE | `/api/v1/account/tenants/{id}/suppressions` | Remove a suppression |
| GET | `/api/health` | Health check |
| POST | `/api/v1/mcp` | MCP server (Streamable HTTP, JSON-RPC 2.0) |
| POST | `/api/v1/integrations/retell/inbound` | Retell call_inbound webhook |
| POST | `/api/v1/integrations/vapi/tool` | Vapi custom (function) tool webhook |
| GET | `/api/v1/receipts/{id}` | Retrieve a signed lookup receipt |
| POST | `/api/v1/sbc/redirect` | SBC / SIP redirect decision |
| GET | `/api/v1/compliance/evidence` | FCC robocall-mitigation evidence bundle |
| GET | `/api/v1/account/signing` | Operator HMAC signing secret (for the calling key) |
| POST | `/api/v1/account/signing` | Enable/disable HMAC signing on the calling key |
| GET | `/api/v1/publickey` | Ed25519 signing public key |
| POST | `/api/v1/report` | Report a number (community sensor) |
| POST | `/api/parse` | Parse a phone number (legacy alias) |
| POST | `/api/parse/bulk` | Parse multiple phone numbers (legacy alias) |
| GET | `/api/countries` | List supported countries (legacy alias) |
| POST | `/api/scrub` | Scrub a calling list (legacy alias) |

## Machine-readable artifacts (23)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/openapi/numbers-online-openapi.yml
- **OpenAPI** — https://numbers.online/api/spec
- **Documentation** — https://numbers.online/docs
- **APIReference** — https://numbers.online/docs
- **GettingStarted** — https://numbers.online/developers
- **Guides** — https://numbers.online/docs/integrations
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/authentication/numbers-online-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/conventions/numbers-online-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/conventions/numbers-online-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/errors/numbers-online-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/rate-limits/numbers-online-rate-limits.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/plans/numbers-online-plans-pricing.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/lifecycle/numbers-online-lifecycle.yml
- **ChangeLog** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/changelog/numbers-online-changelog.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/data-model/numbers-online-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/conformance/numbers-online-conformance.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/overlays/numbers-online-openapi-overlay.yaml
- **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/agentic-access/numbers-online-agentic-access.yml
- **LLMsTxt** — https://numbers.online/llms.txt
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/skills/_index.yml
- **Pricing** — https://numbers.online/pricing
- **SignUp** — https://numbers.online/developers
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/numbers-online/refs/heads/main/apis.yml

## Other Numbers Online APIs (2)

- [Numbers Online MCP Server](https://apis.io/apis/numbers-online/numbers-online-mcp-server/)
- [Numbers Online A2A Agent](https://apis.io/apis/numbers-online/numbers-online-a2a-agent/)

## Tags

Phone Intelligence, Caller ID, CNAM, Do Not Call, Telephony

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/numbers-online/numbers-online-phone-intelligence-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/numbers-online/.