Skip to content

Get state transitions by payment ID

Request

Returns the complete state transition history for a payment, including each status change and its timestamp. Use this to audit payment progress or debug processing issues.

Security
Bearer
Path
paymentIdstring, (uuid)required

Unique identifier of the payment for which you want to get state transition information.

Example:7ea3399c-1234-5678-8d8f-d320ea406630
curl -i -X GET \
  https://docs.ripple.com/_mock/products/payments-direct-2/api-docs/payments-direct-api/payments-direct-2-api/v3/payments/7ea3399c-1234-5678-8d8f-d320ea406630/states \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successfully fetched payment state transitions.

Bodyapplication/json
stateTransitionsArray of objectsrequired
Response
{
  "stateTransitions": [
    { … }
  ]
}