numverify API
★ Only Publicly Available OpenAPI DocumentData EnrichmentContact EnrichmentapiKey1 EndpointsREST
For Agents
Validate an international phone number and return its country, carrier, line type, and location through a single GET call.
Use for: Validate an international phone number through numverify, Get the carrier name for a phone number, Check whether a phone number is a mobile line, Find the country code for a submitted phone number
Not supported: Does not send SMS, place calls, or perform identity verification — use for phone-number validation and carrier enrichment only.
Jentic publishes the only available OpenAPI specification for numverify API, keeping it validated and agent-ready. numverify is an apilayer-hosted phone-number validation and lookup service that returns line type, carrier, country, and location for an international phone number. The API exposes a single GET endpoint that accepts the number and an access key as a query parameter and returns the enriched JSON result. It is used by signup forms, marketing-list cleansers, and SMS routers that need a fast yes-or-no validity check plus basic carrier metadata.
Install Jentic One Beta
Connect the numverify API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the numverify API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with numverify API.
Validate an international phone number and return its country code
Return the carrier name attached to a validated phone number
Identify whether a number is a mobile, landline, or special line type
Geo-locate a phone number to its associated region
Filter signup forms for unreachable phone numbers
Use Cases
Patterns agents use numverify API for, with concrete tasks.
★ Signup Form Validation
Web forms call GET /validate with the user's phone number and the apilayer access key to confirm the number is real before saving the lead. The response includes a valid flag plus carrier and line type, which downstream systems use to score the lead. Integration is a single HTTP GET.
Call GET /validate with the submitted number and the access key, reject the signup if valid is false
Marketing List Hygiene
Marketing teams clean uploaded contact lists by passing each number through numverify and discarding entries flagged invalid or as VoIP. Cleaner lists improve SMS deliverability rates and cut spend on unreachable numbers. The single-endpoint surface makes batch processing straightforward.
Iterate over a list of phone numbers calling GET /validate for each, retain only those where line_type is mobile and valid is true
Agent-Driven Lead Quality Scoring
An AI agent triages inbound leads by validating phone numbers through numverify and writing the carrier, country, and line type back to the CRM. Through Jentic the agent searches for 'validate phone number', loads the GET /validate schema, and executes without learning apilayer's auth conventions.
Search Jentic for 'validate a phone number', load the schema for GET /validate, and execute for each new lead with the apilayer access key
Key Endpoints
1 endpoints — jentic publishes the only available openapi specification for numverify api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/validate
Validate a phone number
GET
/validate
Validate a phone number
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
numverify access keys are stored encrypted in the Jentic vault and injected as the access_key query parameter at execution. The raw key is never exposed to the model context, even though the API expects it in the URL.
Intent-based discovery
Agents search Jentic with intents like 'validate a phone number' or 'check phone carrier' and Jentic returns the numverify operation with its schema.
Time to first call
Direct numverify integration: a couple of hours. Through Jentic: under 10 minutes — search, load, execute, with credentials handled.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using numverify API through Jentic.
Why is there no official OpenAPI spec for numverify API?
numverify does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call numverify API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the numverify API use?
The spec declares an apiKey scheme passed as a query parameter named access_key. Through Jentic the access key is stored encrypted in the vault and appended at execution time, so it never appears in the agent's prompt or logs.
Can numverify tell me whether a number is a landline or VoIP?
Yes. The response from GET /validate includes a line_type field that distinguishes mobile, landline, VoIP, and other categories. Use it to filter out non-mobile numbers before sending SMS.
How do I validate a phone number through Jentic?
Search Jentic for 'validate a phone number', load the schema for GET /validate, and execute with the number you want to check. Jentic injects the access key from the vault and returns the parsed validation payload.
What are the rate limits for the numverify API?
Rate limits are not declared in the OpenAPI spec. numverify operates on apilayer's plan-based monthly request limits; check your apilayer dashboard for the exact quota tied to your access key.
Is numverify free to use?
numverify offers a free apilayer tier for low-volume validation and paid tiers for higher request volumes. The free tier is sufficient for most signup-form workflows but caps monthly requests; check apilayer pricing for details.
GET STARTED