Log in Get an API key

API Reference › Phone Verification & DNC

Phone Verification

POST /v1/api/phone/verify/

Cost: 5 credits per hit. 0 when nothing is found.

Rate limit: 500 lookups per minute per account, shared with the other instant lookups. Each array item counts as one.

Mode: Sync

Synchronous phone intelligence endpoint. Send one phone object or an array of up to 15 phone objects and get back line type, carrier, last-seen date, returned DNC/TCPA flags, returned state DNC codes, contactability, and light associated-person context. Array requests: results stay in input order, each item is validated and billed independently, and the response returns results plus aggregate credits_deducted. 5 credits per hit, 0 credits on miss. Rate limited to 500 lookup items per minute per account through the shared instant-lookup counter; every object in an array counts as one item. Different from reverse phone append: this endpoint is not meant to return every person, address, email, and phone connected to the number. It verifies the searched phone itself and returns compact CRM-safe status fields. state_dnc: returned as an array of state codes, for example ["TX"]. An empty array means no provider-returned state DNC flag was found; it is not a full legal clearance across every state registry. contactable: true only when the returned suppression fields are not flagged. It is not legal advice and does not create consent. Related endpoints: DNC Scrub · DNC Scrub from a Trace · DNC Lookup

Fields

Responses