Get Person Hierarchy

GET

/fidix/v1/persons/{{person_id}}/hierarchy

Get a person and all their descendants in a hierarchical tree structure

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de Header

Respuestas

🟢200

application/json

Body

🟠400

🟠401

🟠404

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location -g --request GET '/fidix/v1/persons/{{person_id}}/hierarchy' \
--header 'X-Organization-ID: {{organization_id}}' \
--header 'Authorization: Bearer <token>'

Ejemplo de Respuesta

200 - 200 - Hierarchy with 3 Levels

{
  "data": {
    "id": "92061b7d-4792-4ad8-b918-ec1587d8fdca",
    "organization_id": "00000000-0000-0000-0000-000000000001",
    "person_type": "LEGAL",
    "email": "contacto@fidi.cl",
    "status": "ACTIVE",
    "company_name": "Fidi SpA",
    "tax_id": "76123456-7",
    "created_at": "2025-12-22T10:30:00Z",
    "updated_at": "2025-12-22T10:30:00Z",
    "level": 0,
    "children": [
      {
        "id": "56c3090c-b7e8-4c39-acb9-9e76bd4419c6",
        "parent_person_id": "92061b7d-4792-4ad8-b918-ec1587d8fdca",
        "organization_id": "00000000-0000-0000-0000-000000000001",
        "person_type": "NATURAL",
        "email": "employee1@example.com",
        "status": "ACTIVE",
        "first_name": "Juan",
        "last_name": "Pérez",
        "created_at": "2025-12-22T10:35:00Z",
        "updated_at": "2025-12-22T10:35:00Z",
        "level": 1,
        "children": [
          {
            "id": "768c5e61-e69c-4f82-a1b6-78906ed4fe70",
            "parent_person_id": "56c3090c-b7e8-4c39-acb9-9e76bd4419c6",
            "organization_id": "00000000-0000-0000-0000-000000000001",
            "person_type": "NATURAL",
            "email": "dependent1@example.com",
            "status": "ACTIVE",
            "first_name": "María",
            "last_name": "Pérez",
            "created_at": "2025-12-22T10:40:00Z",
            "updated_at": "2025-12-22T10:40:00Z",
            "level": 2,
            "children": []
          }
        ]
      },
      {
        "id": "6d7234cf-2cc3-492d-970d-d2f03e10b858",
        "parent_person_id": "92061b7d-4792-4ad8-b918-ec1587d8fdca",
        "organization_id": "00000000-0000-0000-0000-000000000001",
        "person_type": "NATURAL",
        "email": "employee2@example.com",
        "status": "ACTIVE",
        "first_name": "Ana",
        "last_name": "González",
        "created_at": "2025-12-22T10:37:00Z",
        "updated_at": "2025-12-22T10:37:00Z",
        "level": 1,
        "children": []
      }
    ]
  },
  "metadata": {
    "trace_id": "xyz-789-abc-123",
    "timestamp": "2025-12-22T11:00:00Z"
  }
}

Modificado en 2025-12-22 20:48:00

Get Person by ID

List Persons