/api/v6/account/adjustmentsBalance adjustments
Manual balance adjustments applied to the account.
Scope and limits
API key with the account capability granted
30 requests per minute
- Pagination with
limit(default 20, max 100) andoffset(default 0). The response carriesdata.itemsanddata.pagination.
Manual balance adjustments for the account. Hablame manages them with dual approval (whoever records an adjustment is not the one who approves it). Amounts carry 6 decimals.
Pagination with limit (default 20, max 100) and offset (default 0). The response carries data.items and data.pagination.
Sensitive financial data
The API key must have the account capability explicitly enabled. Access to all services does NOT grant it: it is granted separately, per key, from the customer portal (Developers → API keys). A key without the capability gets 403.
Query parameters
limitDefault: 20
offsetDefault: 0
statusResponses
Page of adjustments.
{
"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
}
}Invalid or missing credentials.
The API key lacks the required capability, or the organization cannot run the request.
Request limit exceeded. Wait for Retry-After.
Possible errors
Codes this endpoint can return in error.code. The full detail lives in the catalog.
AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.401AUTH_SERVICE_NOT_ALLOWEDThe key is not allowed to use the service behind this endpoint.403ACCOUNT_NOT_ACTIVEYour organization is suspended or closed.403ACCOUNT_BLOCKEDA full block is active: every call is rejected.403ACCOUNT_CONFIG_NOT_FOUNDWe could not load the organization behind your key.403FORBIDDENGeneric 403: fallback when no `ACCOUNT_*` applies.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.