GET
/lending/v1/hierarchies/{id}/nodesBuscar nodos de una jerarquía
El endpoint lending/v1/hierarchies/{id}/nodes te permite buscar nodos de una jerarquía por su ID, por el usuario o por una tarjeta asociada.
- Tenés que enviar al menos uno de
filter[id],filter[user_id]ofilter[card_id]; si no, se responde 400BAD_REQUEST. Si enviás más de uno, se aplica solo el primero en este orden:filter[id],filter[user_id],filter[card_id]. filter[id]yfilter[card_id]devuelven como máximo un nodo, sin paginación.filter[user_id]devuelve todos los nodos del usuario en la jerarquía, paginados.- Si ningún nodo coincide con el filtro, se responde 200 con
datavacío. lifecycle.statuses el estado efectivo del nodo: el más restrictivo entre el suyo y el de sus ancestros, en este orden:CANCELED,EXPIRED,PAUSED,PENDING,ACTIVE. Por ejemplo, un usuarioACTIVEdentro de un áreaPAUSEDse devuelvePAUSED.
Parámetros disponibles
Path Parameters
idStringrequired
Query Parameters
filter[id]String
filter[user_id]String
filter[card_id]String
page[size]Integer
page[number]Integer
Autenticación
🔒BearerAuthhttp
Detalle de respuestas
401
El token falta o es inválido. La respuesta no tiene cuerpo.
403
Sin cuerpo. El token es válido pero no tiene el scope que requiere el endpoint.
Ejemplo de código
curl -X GET "https://api.pomelo.la/lending/v1/hierarchies/example_value/nodes?filter[id]=nod-2HMwKzetERdOEhbT86UweXamPle&filter[user_id]=usr-2HMvSDccc5PZzCvZ98lfeXamPle&filter[card_id]=crd-2HMvSDccc5PZzCvZ98lfeXamPle&page[size]=10&page[number]=0" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta (200)Nodos que coinciden con el filtro
{
"data": [
{
"id": "nod-2HMwKzetERdOEhbT86UweXamPle",
"hierarchy_id": "hie-2HMwKzetERdOEhbT86UweXamPle",
"parent_node_id": "nod-2HMvSDccc5PZzCvZ98lfeXamPle",
"lifecycle": {
"status": {
"value": {}
},
"created_at": "2026-10-03T14:20:11.120Z",
"updated_at": "2026-10-03T14:20:11.120Z"
},
"name": "Marketing",
"type": "COMPANY_AREA",
"link_ref": {
"id": "lcr-2HMwKzetERdOEhbT86UweXamPle",
"type": "CREDIT_LINE"
},
"card_ids": [
"crd-2HMvSDccc5PZzCvZ98lfeXamPle"
],
"ancestor_ids": [
"nod-2HMvSDccc5PZzCvZ98lfeXamPle"
],
"credit": {
"validity_period": {
"start_date": "2026-11-01",
"end_date": "2027-10-31"
},
"renewal_policy": {
"frequency": "MONTHLY"
},
"balance": {
"source": "OWNED",
"currency": "PEN",
"limit_type": "PER_OPERATION",
"restitution_type": "EXTENDED",
"single_payment": {
"limit": 4000,
"utilization": 1250,
"available": 2750
},
"installments": {
"limit": 4000,
"utilization": 1250,
"available": 2750
},
"cash_advance": {
"limit": 1000,
"utilization": 0,
"available": 1000,
"percentage_of_single_payment": 30
}
}
},
"rules": [
{
"rule_id": "2HMwKzetERdOEhbT86UweXamPle",
"type": "MCC",
"condition": {},
"value": [
"5411",
"5412"
],
"action": {}
}
]
}
],
"meta": {
"pagination": {
"total_pages": 1,
"current_page": 0,
"page_size": 10
}
}
}