curl -X GET 'https://api.yativo.com/api/v1/beneficiaries/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"data": {
"id": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
"user_id": "usr-001",
"recipient_type": "individual",
"customer_name": "Maria Gonzalez",
"customer_email": "maria.gonzalez@example.com",
"customer_nickname": "Maria",
"country": "CHL",
"customer_address": "123 Main Street, Santiago",
"is_archived": false,
"created_at": "2026-04-02T10:00:00.000000Z",
"updated_at": "2026-04-02T10:00:00.000000Z"
}
}
Get Beneficiary
Retrieve details for a specific beneficiary
GET
/
beneficiaries
/
{id}
curl -X GET 'https://api.yativo.com/api/v1/beneficiaries/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"data": {
"id": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
"user_id": "usr-001",
"recipient_type": "individual",
"customer_name": "Maria Gonzalez",
"customer_email": "maria.gonzalez@example.com",
"customer_nickname": "Maria",
"country": "CHL",
"customer_address": "123 Main Street, Santiago",
"is_archived": false,
"created_at": "2026-04-02T10:00:00.000000Z",
"updated_at": "2026-04-02T10:00:00.000000Z"
}
}
Returns full details for a specific beneficiary.
GET /v1/beneficiaries/{id}
curl -X GET 'https://api.yativo.com/api/v1/beneficiaries/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"data": {
"id": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
"user_id": "usr-001",
"recipient_type": "individual",
"customer_name": "Maria Gonzalez",
"customer_email": "maria.gonzalez@example.com",
"customer_nickname": "Maria",
"country": "CHL",
"customer_address": "123 Main Street, Santiago",
"is_archived": false,
"created_at": "2026-04-02T10:00:00.000000Z",
"updated_at": "2026-04-02T10:00:00.000000Z"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Path Parameters
The ID of the beneficiary to retrieve.

