Enrichment

Reverse phone lookup

Returns the person or business behind a US phone number. lookup_source picks the record: standard reads caller ID records (10 credits), premium searches full owner records (25 credits). Nothing is charged when there is no match.

post/reverse-phone-lookup

Request

  • Base URL: https://app.1lookup.io/api/v1
  • URL: https://app.1lookup.io/api/v1/reverse-phone-lookup
  • Auth: HTTP bearer

Request body

phone_numberstring required

US phone number to look up.

lookup_source'standard' | 'premium'

standard: caller ID records, 10 credits. premium: full owner records, 25 credits. Any other value is refused with 400 INVALID_INPUT.

bypass_cacheboolean

Skip the 7-day result cache and run a fresh lookup. Also accepted as bypassCache or forceFresh, in the body or the query string. A cached result you ran yourself is free; a fresh lookup is charged as usual.

Example request

{
  "phone_number": "+14155552671"
}

Response

Lookup completed. metadata.credits_used says what it cost.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.