GET /apiv2/billing/payments

Your payments for postpaid invoices, and the credit left from overpayments. You pay in the currency and network of your contract — see settlement in account. Part of postpaid billing.

Endpoint URL

GET https://netts.io/apiv2/billing/payments

Request headers

Header	Required	Description
X-API-KEY	yes	API key with the billing.read permission
X-Real-IP	yes	An address from the key whitelist

The request has no parameters.

Example

curl -s 'https://netts.io/apiv2/billing/payments' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "payments": [
      {
        "id": 7,
        "network": "ethereum",
        "txHash": "0x8f3c5a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5e21a",
        "fromAddress": "0x1111111111111111111111111111111111111111",
        "toAddress": "0x2222222222222222222222222222222222222222",
        "amountUsdc": "1300.000000",
        "confirmedAt": "2026-10-21T09:15:00+00:00",
        "status": "confirmed",
        "invoiceId": 12
      }
    ],
    "creditUsdc": "49.600000"
  },
  "timestamp": "2026-10-21T09:20:00+00:00"
}

Fields

Field	Description
network, txHash	the network and the transaction of the payment
fromAddress, toAddress	your wallet and the Netts payment address
amountUsdc	the amount received, in the currency of your contract
confirmedAt	when the payment was credited, UTC
status	confirmed, or reversed if the payment was cancelled
invoiceId	the invoice the payment was made for, or null
creditUsdc	money paid above your invoices, in the currency of your contract; it covers the next charges and is shown as creditApplied in limits

A payment made for an invoice covers the charges of that invoice first, then the oldest unpaid charges; a payment without an invoice covers the oldest unpaid charges first. Payments are listed newest first; an account with no payments gets an empty list.

Errors

HTTP	code	Meaning
401	-1, -2	the key is missing or invalid, or the IP is not whitelisted — answered by the API gateway, see response format
403	billing_read_required, postpaid_required	no permission, or no postpaid billing