Obtener usuarios de una Fintech con préstamos activos

Obtener usuarios de una Fintech con préstamos activos #

Este método permite obtener los usuarios pertenecientes a una Fintech que tienen créditos activos.

URL del endpoint #

GET /financial-entity-users-with-loans

Parámetros de consulta #

Parámetro Tipo Descripción
id string (Obligatorio) ID único de la entidad financiera.
limit int (Opcional) Límite de resultados por página.
offset int (Opcional) Desplazamiento de resultados.

Encabezados #

Encabezado Valor
Authorization Bearer {token}
Content-Type application/json

Respuesta esperada #

La respuesta contendrá una lista de usuarios con préstamos activos.

  • En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:
{
  "size": ["tamaño de la lista"],
  "data": [
    {
      "id": ["ID del usuario"],
      "name": ["Nombre del usuario"],
      "email": ["Correo electrónico del usuario"],
      "loans": [
        {
          "id": ["ID del préstamo"],
          "amount": ["Monto del préstamo"],
          "status": ["Estado del préstamo"]
        }
      ]
    }
  ]
}
  • En caso de error, se devolverá una respuesta con el código de estado correspondiente y un mensaje de error.

Ejemplos de uso #

Python # 

import requests

url = "https://api.leancore.co/financial-entity-users-with-loans"
headers = {
    "Authorization": "Bearer [Token de acceso]"
}
params = {
    "id": "89949613-2a1d-4b46-9961-4379d05b2fc6",
    "limit": 10,
    "offset": 0
}

# Realizar la solicitud GET
response = requests.get(url, headers=headers, params=params)

# Obtener la respuesta en formato JSON
data = response.json()

# Procesar la respuesta
if response.status_code == 200:
    # Éxito: acceder a los usuarios y sus préstamos
    size = data["size"]
    users = data["data"]
    for user in users:
        user_id = user["id"]
        user_name = user["name"]
        user_email = user["email"]
        loans = user["loans"]
        # Procesar los datos de cada préstamo
        for loan in loans:
            loan_id = loan["id"]
            loan_amount = loan["amount"]
            loan_status = loan["status"]
            # Realizar acciones con los datos del préstamo
        # Realizar acciones con los datos del usuario
    # Realizar acciones generales con los usuarios y préstamos
else:
    # Error: mostrar mensaje de error
    error_message = data["message"]
    print(f"Error {response.status_code}: {error_message}")