GET/api/v6/account/payments

Payments history

Prepaid top-ups and postpaid invoice payments, from a single source.

Scope

API key with the account capability granted

Usage limit

30 requests per minute

Pagination with limit (default 20, max 100) and offset (default 0). The response carries data.items and data.pagination.

Payments history: prepaid top-ups and postpaid invoice payments come from the same source. The kind field distinguishes recharge from invoice_payment. 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

limit

integeroptional

How many items to return (1 to 100).

Default: 20

offset

integeroptional

Where to start from.

Default: 0

status

stringoptional

Optional status filter.

Responses

200

Page of payments.

{
  "success": true,
  "data": {
    "items": [
      {
        "reference": "HBL-3WWG4VEH92",
        "kind": "recharge",
        "amount": "50000.000000",
        "currency": "COP",
        "status": "approved",
        "method": "new_card",
        "processor": "epayco",
        "createdAt": "2026-05-18 12:30:00",
        "approvedAt": "2026-05-18 12:31:15",
        "expiresAt": null
      }
    ],
    "pagination": { "limit": 20, "offset": 0, "returned": 1, "hasMore": false }
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-02T19:43:59+00:00",
    "responseTimeMs": 4.1
  }
}

401

Invalid or missing credentials.

403

The API key lacks the required capability, or the organization cannot run the request.

429

Request limit exceeded. Wait for Retry-After.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_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.

See the full catalog

Scope and limits

Query parameters

Responses

Possible errors