/api/v6/account/adjustmentsAjustes de saldo
Ajustes manuales de saldo aplicados a la cuenta.
Alcance y límites
API key con la capacidad account concedida
30 solicitudes por minuto
- Paginación con
limit(por defecto 20, máximo 100) yoffset(por defecto 0). La respuesta traedata.itemsydata.pagination.
Ajustes manuales de saldo de la cuenta. Los gestiona Hablame con doble aprobación (quien lo registra no es quien lo aprueba). Los montos vienen con 6 decimales.
Paginación con limit (por defecto 20, máximo 100) y offset (por defecto 0). La respuesta trae data.items y data.pagination.
Información financiera sensible
La API key debe tener habilitada explícitamente la capacidad account. Tener acceso a todos los servicios NO la concede: se otorga aparte, por clave, desde el portal de clientes (Desarrolladores → Claves API). Una key sin la capacidad recibe 403.
Parámetros de consulta
limitPor defecto: 20
offsetPor defecto: 0
statusRespuestas
Página de ajustes.
{
"success": true,
"data": {
"items": [
{
"reference": "ADJ-20260602-6f0cf241",
"direction": "debit",
"amount": "10000.000000",
"currency": "COP",
"category": "manual",
"status": "approved",
"effectiveDate": "2026-06-02",
"reason": "ajuste inicial",
"createdAt": "2026-06-02 10:00:00"
}
],
"pagination": { "limit": 20, "offset": 0, "returned": 1, "hasMore": false }
},
"meta": {
"requestId": "b9b1704baffab21150213c02fd853975",
"timestamp": "2026-06-02T19:43:59+00:00",
"responseTimeMs": 4.1
}
}Credenciales inválidas o faltantes.
La API key no tiene la capacidad requerida, o la organización no puede ejecutar la solicitud.
Se excedió el límite de solicitudes. Espera lo que indique Retry-After.
Errores posibles
Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.
AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.403ACCOUNT_BLOCKEDHay un bloqueo total activo: cada llamada se rechaza.403ACCOUNT_CONFIG_NOT_FOUNDNo pudimos cargar la organización de tu key.403FORBIDDEN403 genérico: alternativa cuando no aplica un `ACCOUNT_*`.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.