v1

latestOpenAPI 3.0.1MIT2026-07-22241852.5 KB

List Payments

Returns payments collected for your organization over a date range, newest first.

get/payments

Query parameters

start_datestring required

Start of date range, inclusive. Accepts YYYY-MM-DD (interpreted as 00:00:00 UTC) or a full ISO 8601 UTC timestamp like 2026-06-18T04:00:00Z

end_datestring required

End of date range. Accepts YYYY-MM-DD (covers that entire UTC day, including the final sub-second) or a full ISO 8601 UTC timestamp (inclusive). Must be on or after start_date and within 366 days of it.

status'success' | 'failed' | 'declined' | 'error'

Filter by payment status

payment_type'flat' | 'subscription' | 'settlement' | 'remainder'

Filter by payment type. flat = one-time payment, subscription = payment-plan installment, settlement = settlement payment, remainder = remainder charge after a partial payment

payment_method'ach' | 'card'

Filter by payment method (matched case-insensitively)

limitinteger

Page size. Defaults to 50, maximum 100.

starting_afterstring

Pagination cursor: the id of the last payment on the previous page (also returned as pagination.next_cursor). Must reference a payment of your organization inside the queried date range.

Response

Payments retrieved successfully

objectstring

Object type identifier

countinteger

Number of payments on this page

Example response

{
  "object": "list.payments",
  "period": {
    "start_date": "2026-06-18",
    "end_date": "2026-06-18"
  },
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "count": 1,
  "payments": [
    {
      "id": "pi_3RxT81GhIJk2LmNo",
      "object": "payment",
      "debtor_id": "ACC482910",
      "client_name": "Sunrise Medical Group",
      "call_id": "call_9f2ab61c3d",
      "amount": 245.16,
      "currency": "usd",
      "processor": "stripe",
      "payment_type": "flat",
      "payment_method": "CARD",
      "status": "success",
      "transaction_id": "ch_3RxT81GhIJk2LmNo",
      "phone": "+15555550123",
      "recurrence_rule": null,
      "total_installments": null,
      "next_payment_date": null,
      "created_at": "2026-06-18T14:22:07.318Z"
    }
  ]
}