Trips

List a trip's payments

GET/api/v1/trips/{id}/paymentsScope payments:read

The same payments the client sees on their trip page: never cancelled ones or ones still being prepared. Returned whole, never paged, as one list: what is due first, by due date (undated last); then what is paid, most recent first. The page groups split payments together; this list does not.

Amounts are integers in minor units: 125000 in EUR is €1,250.00. See Money, dates and versions.

Path parameters

idstring

Query parameters

No parameters.

Returns

A list of Payment objects.

object"list"

dataarray of Payment

next_cursorstring or null

Errors

401unauthorizedNo key, a malformed one, or a key that does not exist or was revoked. Send it as Authorization: Bearer <key>.

403api_not_enabledRoundPlan has not turned on API access for this agency.

403subscription_inactiveThe agency's trial expired or its subscription ended.

403insufficient_scopeThe key cannot read this. An owner adds payments:read to a key in Settings → API.

404not_foundNothing with that id in this agency.

429rate_limitedToo many requests. Wait the seconds in Retry-After. See Errors and rate limits.

500internal_errorSomething went wrong on our side. Retry later.

{ "object": "list", "data": [ { "object": "payment", "id": "c41a0e77-3b92-4f6d-8a15-6e0d2b9f13a4", "trip_id": "5b2f9c1e-7d4a-4c1b-9e3a-2a8f1c6d4e70", "type": "deposit", "description": "Deposit · 30% to confirm the booking", "traveler": { "id": "t-8b41c2", "name": "Carla" }, "group_id": null, "amount": { "amount": 74400, "currency": "EUR" }, "paid": { "amount": 0, "currency": "EUR" }, "outstanding": { "amount": 74400, "currency": "EUR" }, "status": "due", "due_date": "2026-09-30", "paid_at": null, "pay_url": "https://app.roundplan.io/pay/4c8e1a9b2d7f3e60", "created_at": "2026-09-21T16:45:00Z", "updated_at": "2026-09-26T11:05:00Z" } ], "next_cursor": "eyJ1IjoiMjAyNi0wOS0yNlQxMTowNTowMFoiLCJpIjoiYzQxYTBlNzctM2I5Mi00ZjZkLThhMTUtNmUwZDJiOWYxM2E0In0" }