curl --request POST \
--url https://api.pubrio.com/redeem/people/batch \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"peoples": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"people_contact_types": [
"email-personal",
"email-work",
"phone"
],
"profile_id": 123
}
'import requests
url = "https://api.pubrio.com/redeem/people/batch"
payload = {
"peoples": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"people_contact_types": ["email-personal", "email-work", "phone"],
"profile_id": 123
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
peoples: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
people_contact_types: ['email-personal', 'email-work', 'phone'],
profile_id: 123
})
};
fetch('https://api.pubrio.com/redeem/people/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/redeem/people/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'peoples' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'people_contact_types' => [
'email-personal',
'email-work',
'phone'
],
'profile_id' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pubrio.com/redeem/people/batch"
payload := strings.NewReader("{\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"people_contact_types\": [\n \"email-personal\",\n \"email-work\",\n \"phone\"\n ],\n \"profile_id\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pubrio.com/redeem/people/batch")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"people_contact_types\": [\n \"email-personal\",\n \"email-work\",\n \"phone\"\n ],\n \"profile_id\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/redeem/people/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"people_contact_types\": [\n \"email-personal\",\n \"email-work\",\n \"phone\"\n ],\n \"profile_id\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
"is_completed": false,
"estimated_time": 6,
"estimated_time_type": "second"
}
}{
"code": 40001,
"message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
"details": {}
}{
"error": "Request rate limit exceeded. Please wait and try again later."
}{
"error": "An unexpected error occurred on the server."
}Redeem People - Bulk
Submit a batch request to unlock contact details for multiple people at once.
curl --request POST \
--url https://api.pubrio.com/redeem/people/batch \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"peoples": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"people_contact_types": [
"email-personal",
"email-work",
"phone"
],
"profile_id": 123
}
'import requests
url = "https://api.pubrio.com/redeem/people/batch"
payload = {
"peoples": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"people_contact_types": ["email-personal", "email-work", "phone"],
"profile_id": 123
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
peoples: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
people_contact_types: ['email-personal', 'email-work', 'phone'],
profile_id: 123
})
};
fetch('https://api.pubrio.com/redeem/people/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/redeem/people/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'peoples' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'people_contact_types' => [
'email-personal',
'email-work',
'phone'
],
'profile_id' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pubrio.com/redeem/people/batch"
payload := strings.NewReader("{\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"people_contact_types\": [\n \"email-personal\",\n \"email-work\",\n \"phone\"\n ],\n \"profile_id\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pubrio.com/redeem/people/batch")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"people_contact_types\": [\n \"email-personal\",\n \"email-work\",\n \"phone\"\n ],\n \"profile_id\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/redeem/people/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"people_contact_types\": [\n \"email-personal\",\n \"email-work\",\n \"phone\"\n ],\n \"profile_id\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
"is_completed": false,
"estimated_time": 6,
"estimated_time_type": "second"
}
}{
"code": 40001,
"message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
"details": {}
}{
"error": "Request rate limit exceeded. Please wait and try again later."
}{
"error": "An unexpected error occurred on the server."
}Authorizations
Body
A list of unique identifiers (people_search_id) used for people search operations.
This parameter controls the retrieval of various details such as work email address, personal email address, phone number. You can enter one or all.
email-personal, email-work, phone ["email-personal", "email-work", "phone"]
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 bulk redeem people status.
Response info depends on specific endpoint.

