---
updatedAt: 2026-04-03T20:38:29.000Z
agentTools:
  projectIndex: https://docs.atratopago.com/llms.txt
---

# Buscar usuario

Busca los créditos de un usuario por número de referencia CIE o por el ID de la solicitud. Se requiere al menos uno de los dos parámetros. Devuelve los datos del usuario y los créditos activos con montos disponibles para pago.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-partners",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api-sandbox.atratopago.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-auth-token"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/v4/integration/cash-in/search": {
      "get": {
        "description": "",
        "responses": {
          "200": {
            "description": "Usuario encontrado con créditos activos. Devuelve los datos del usuario y los créditos activos con montos disponibles para pago.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "userName": {
                      "type": "string",
                      "default": "",
                      "description": "Nombre del cliente."
                    },
                    "userId": {
                      "type": "integer",
                      "description": "ID del usuario (usar en el registro de pago)."
                    },
                    "credits": {
                      "type": "object",
                      "properties": {
                        "creditId": {
                          "type": "integer",
                          "description": "ID del crédito (usar en el registro de pago)."
                        },
                        "debtToDate": {
                          "type": "number",
                          "description": "Deuda al día."
                        },
                        "settleAmount": {
                          "type": "number",
                          "description": "Monto para liquidar."
                        },
                        "installmentAmount": {
                          "type": "number",
                          "description": "Monto de la mensualidad."
                        },
                        "merchantName": {
                          "type": "string",
                          "description": "Nombre del comercio al que pertenece el crédito."
                        }
                      }
                    }
                  },
                  "required": [
                    "userName"
                  ]
                },
                "examples": {
                  "": {
                    "summary": "",
                    "value": {
                      "userName": "string",
                      "userId": 0,
                      "credits": [
                        {
                          "creditId": 0,
                          "debtToDate": 0,
                          "settleAmount": 0,
                          "merchantName": "string",
                          "installmentAmount": 0
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "No se proporcionó ningún criterio de búsqueda. Se requiere al menos uno de los dos parámetros.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Mensaje de error."
                    },
                    "details": {
                      "type": "string",
                      "description": "Detalles del error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                },
                "examples": {
                  "": {
                    "summary": "",
                    "value": {
                      "message": "No se proporcionó ningún criterio de búsqueda"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "No se proporcionó el token de autenticación. Se debe usar el token obtenido con el endpoint /api/v4/integration/login.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Mensaje de error."
                    },
                    "details": {
                      "type": "string",
                      "description": "Detalles del error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                },
                "examples": {
                  "": {
                    "summary": "",
                    "value": {
                      "message": "string",
                      "details": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No se encontró ningún usuario con los criterios de búsqueda proporcionados.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Mensaje de error."
                    },
                    "details": {
                      "type": "string",
                      "description": "Detalles del error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                },
                "examples": {
                  "": {
                    "summary": "",
                    "value": {
                      "message": "No se encontraron créditos activos para este usuario"
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "in": "query",
            "name": "reference",
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Número de referencia CIE asignado al cliente (inicia con la letra 'U')."
          },
          {
            "in": "query",
            "name": "applicationId",
            "schema": {
              "type": "integer",
              "default": ""
            },
            "description": "ID de la solicitud de crédito."
          }
        ],
        "operationId": "get_api-v4-integration-cash-in-search"
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```