List provider participant payments

GET
/providers/{providerID}/participants/{participantID}/payments

List the payments that involve one of your participants: payouts and requests for payment, sent or received. direction on each item is the money movement relative to the participant. Returns an empty list when none exist.

Pagination is cursor-based. Omit cursor to fetch the first page; use nextCursor from each response to fetch the next page.

Auth: API key or bearer token. Scoped to the calling provider.

Request
cURL
curl -X GET https://api.moov.money/providers/{providerID}/participants/{participantID}/payments
Responses
200 400 401 403 404
The request completed successfully.
{
  "payments": [
    {
      "amount": {
        "currency": {
          "code": "USD",
          "decimalPlaces": 2,
          "name": "US Dollar",
          "numericCode": "840"
        },
        "value": "100.00"
      },
      "counterparty": {
        "displayName": "Jane Doe",
        "phoneNumber": "+15555551234"
      },
      "createdOn": "2026-08-31T12:00:00Z",
      "direction": "sent",
      "id": "pay_01HF5J9ZKQT4RXP8M2VYBN3D",
      "memo": "Rent split",
      "status": "initiated",
      "type": "payout"
    }
  ]
}
Malformed request: the body or headers failed validation.
Authentication missing, invalid, or insufficient.
Authentication present but the action is forbidden for this principal/claim.
The requested resource was not found.

Headers

X-Moov-Version

string
Set this header to the API version being targeted (e.g. v2026.07.00). When omitted, the server applies its default version.

Path parameters

providerID

string required
Your provider account ID.

participantID

string required
The participant’s participantID, or your externalID for them. Both resolve to the same participant.

Query parameters

cursor

string
Opaque pagination cursor from a previous response’s nextCursor. Omit to fetch the first page.

limit

integer <int32>
Maximum number of payments to return. Defaults to 25; values outside 1-100 return 400.

Response

Response envelope for list participant payments.

nextCursor

string
Opaque cursor for the next page; absent on the last page.

hasMore

boolean required
Whether another page of results follows this one.

payments

array<object> required
The page of payments involving the participant, newest first.