Skip to main content
Returns a paginated list of all beneficiaries associated with your account.
GET /beneficiaries
curl -X GET 'https://api.yativo.com/api/v1/beneficiaries' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": [
    {
      "beneficiary_id": "ben-7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
      "name": "Maria Gonzalez",
      "email": "maria.gonzalez@example.com",
      "type": "individual",
      "country": "CHL",
      "created_at": "2026-04-02T10:00:00.000000Z"
    },
    {
      "beneficiary_id": "ben-8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
      "name": "Tech Solutions SA",
      "email": "payments@techsolutions.mx",
      "type": "business",
      "country": "MEX",
      "created_at": "2026-03-20T09:00:00.000000Z"
    }
  ],
  "pagination": {
    "total": 18,
    "per_page": 15,
    "current_page": 1,
    "last_page": 2
  }
}