listPaymentAllocations

List payment allocations

Lists payment allocations, newest first. Filter by payment, by invoice, or both; an ID that matches nothing returns an empty list.

Query Parameters

limit
Type: integer
min:
1
max:
100

How many records to return, 1 to 100.
offset
Type: integer
min:
0

How many records to skip.
paymentId
Type: string

Only allocations of this payment (pay_…).
invoiceId
Type: string

Only allocations to this invoice's lines (inv_…).

Responses

application/json

get/payment-allocations

curl 'https://billing.getspondo.com/api/v1/payment-allocations?paymentId=pay_6Nc1Rf8Hs3Kd9Vg4' \
  --header "Authorization: Bearer $SPONDO_API_KEY"

Show Schema

{
  "data": [
    {
      "id": "pal_4Qr7St0Uv3Wx6Yz9",
      "paymentId": "pay_6Nc1Rf8Hs3Kd9Vg4",
      "invoiceId": "inv_3Rk8Wq1Zp6Ty0Xm2",
      "invoiceLineId": "inv_3Rk8Wq1Zp6Ty0Xm2-1",
      "amount": 1296,
      "currency": "USD",
      "type": "allocated",
      "status": "applied",
      "allocationDate": "2026-11-10T09:15:22.104Z",
      "createdAt": "2026-11-10T09:15:22.104Z"
    },
    {
      "id": "pal_9Df2Gh5Jk8Lm1Np3",
      "paymentId": "pay_6Nc1Rf8Hs3Kd9Vg4",
      "invoiceId": "inv_3Rk8Wq1Zp6Ty0Xm2",
      "invoiceLineId": "inv_3Rk8Wq1Zp6Ty0Xm2-0",
      "amount": 10692,
      "currency": "USD",
      "type": "allocated",
      "status": "applied",
      "allocationDate": "2026-11-10T09:15:22.104Z",
      "createdAt": "2026-11-10T09:15:22.104Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 2,
    "hasMore": false
  }
}

A page of payment allocations.

Create payment allocations

Payment methods