Consultar el estado de un canje en lote
curl --request POST \
--url https://api.pubrio.com/redeem/people/batch/query \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"redeem_query_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.pubrio.com/redeem/people/batch/query"
payload = { "redeem_query_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
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({redeem_query_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.pubrio.com/redeem/people/batch/query', 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/query",
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([
'redeem_query_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
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/query"
payload := strings.NewReader("{\n \"redeem_query_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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/query")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"redeem_query_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/redeem/people/batch/query")
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 \"redeem_query_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"profile": {
"credit": 450376,
"topup_credit": 235237,
"total_charged_credit": 465
},
"query": {
"redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
"is_completed": true,
"estimated_time": 6,
"estimated_time_type": "second"
},
"peoples": [
{
"people_search_id": "540574d1-ff74-475b-aea2-f8ae643b806d",
"emails": [
{
"value": "[email protected]",
"type": "email-personal",
"status": null
},
{
"value": "[email protected]",
"type": "email-work",
"status": "Verified"
}
],
"phones": [
{
"value": "+1123456789",
"type": "phone",
"status": null
}
]
},
"..."
]
}
}{
"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."
}Canjear
Canjear personas - Estado masivo
Comprueba el estado y los resultados de una solicitud de canje en lote enviada previamente.
POST
/
redeem
/
people
/
batch
/
query
Consultar el estado de un canje en lote
curl --request POST \
--url https://api.pubrio.com/redeem/people/batch/query \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"redeem_query_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.pubrio.com/redeem/people/batch/query"
payload = { "redeem_query_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
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({redeem_query_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.pubrio.com/redeem/people/batch/query', 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/query",
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([
'redeem_query_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
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/query"
payload := strings.NewReader("{\n \"redeem_query_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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/query")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"redeem_query_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/redeem/people/batch/query")
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 \"redeem_query_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"profile": {
"credit": 450376,
"topup_credit": 235237,
"total_charged_credit": 465
},
"query": {
"redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
"is_completed": true,
"estimated_time": 6,
"estimated_time_type": "second"
},
"peoples": [
{
"people_search_id": "540574d1-ff74-475b-aea2-f8ae643b806d",
"emails": [
{
"value": "[email protected]",
"type": "email-personal",
"status": null
},
{
"value": "[email protected]",
"type": "email-work",
"status": "Verified"
}
],
"phones": [
{
"value": "+1123456789",
"type": "phone",
"status": null
}
]
},
"..."
]
}
}{
"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."
}Autorizaciones
Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.
Cuerpo
application/json
Cuando se inicia una solicitud de canje masivo, se devuelve un redeem_query_id, que puede usarse aquí para obtener los resultados.
Respuesta
Respuesta exitosa que contiene los detalles del canje masivo de personas.
La información de la respuesta depende del endpoint específico.
Show child attributes
Show child attributes
Última modificación el 4 de septiembre de 2026

