Skip to main content
POST
/
redeem
/
people
Redeem a person's contact details
curl --request POST \
  --url https://api.pubrio.com/redeem/people \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "people_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "people_contact_types": [
    "email-personal",
    "email-work",
    "phone"
  ],
  "linkedin_url": "http://www.linkedin.com/in/king-lai-605382b7",
  "profile_id": 123
}
'
{
  "data": {
    "profile": {
      "credit": 450376,
      "topup_credit": 235237,
      "total_credit_cost": 45
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "emails": [
          {
            "value": "[email protected]",
            "type": "email-personal",
            "status": null
          },
          {
            "value": "[email protected]",
            "type": "email-work",
            "status": "Verified"
          }
        ],
        "phones": [
          {
            "value": "+1123456789",
            "type": "phone",
            "status": null
          }
        ]
      }
    ]
  }
}

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
​
people_search_id
string<uuid>
required

A unique identifier for the people search operation.

​
people_contact_types
enum<string>[]
required

This parameter controls the retrieval of various details such as work email address, personal email address, phone number. You can enter one or all.

Available options:
email-personal,
email-work,
phone
Example:
["email-personal", "email-work", "phone"]
​
linkedin_url
string

The fully formed URL of the LinkedIn user profile. URL begin with http and contain linkedin.com/in/ or linkedin.com/pub/

Example:

"http://www.linkedin.com/in/king-lai-605382b7"

​
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 redeem people details.

​
data
object

Response info depends on specific endpoint.