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
phone (required): 10-digit US phone number. Formatting is stripped automatically, including dashes, spaces, parentheses, and a leading country code 1.
Responses
200: Hit: 5 credits deducted
400: Invalid phone
402: Insufficient credits
429: Rate limit reached: 500 lookups per minute per account, shared with the other instant lookups. Each array item counts as one.
503: Phone verification temporarily unavailable