Skip to main content
POST
/
redeem
/
people
/
contact
/
lookup
Look up a person by contact identifier
curl --request POST \
  --url https://api.pubrio.com/redeem/people/contact/lookup \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "email": "[email protected]",
  "phone": "+15551234567",
  "first_name": "King",
  "last_name": "Lai",
  "domain": "pubrio.com",
  "company": "Pubrio",
  "is_enable_similarity_search": true,
  "profile_id": 123
}
'
{
  "data": {
    "profile": {
      "credit": 450375,
      "topup_credit": 235236,
      "total_credit_cost": 1
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "first_name": "King",
        "last_name": "Lai",
        "people_name": "King Lai",
        "company_name": "Pubrio",
        "domain": "pubrio.com",
        "match": {
          "confidence": "exact",
          "input": {
            "value": "[email protected]",
            "type": "email-work"
          },
          "is_duplicate_input": false
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
pubrio-api-key
string
header
required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json
​
email
string<email>
required

Work or personal email address to look up. The system normalizes case and whitespace before matching.

Example:

"[email protected]"

​
phone
string

Phone number to look up. International (E.164) format is recommended.

Example:

"+15551234567"

​
first_name
string

First name. Used together with last_name and either domain or company when is_enable_similarity_search is true.

Example:

"King"

​
last_name
string

Last name. Used together with first_name and either domain or company when is_enable_similarity_search is true.

Example:

"Lai"

​
domain
string

Company domain used as a similarity-search anchor together with first_name + last_name when is_enable_similarity_search is true.

Example:

"pubrio.com"

​
company
string

Company name used as a similarity-search anchor together with first_name + last_name when is_enable_similarity_search is true and domain is not provided.

Example:

"Pubrio"

​
is_enable_similarity_search
boolean
default:false

When true, falls back to a name-based similarity match if no exact email/phone hit is found. Requires first_name, last_name, and either domain or company.

Example:

true

​
profile_id
integer

Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.

Check out user details endpoints under the Profile tab for more information.

Response

Successful response containing the matched person and match metadata.

​
data
object

Response info depends on specific endpoint.