---
title: "Get payment node status"
method: GET
path: "/payments/{payment_id}/node-status"
tags: ["Non-orchestration payments"]
---

# Get payment node status

`GET /payments/{payment_id}/node-status`

Senders can query for the RippleNet instances (in a given payment chain) that have payments in the <code>LOCKED</code> state. This information is only stored on the sender's RippleNet instance.

## Path parameters

- `payment_id` string, uuid, required

## Response `200`

Successfully retrieved payment states on each node participating in the payment.

- NodeStatus[]
  - `paymentId` string, uuid, required — Unique identifier of the payment.
  - `paymentState` 'QUOTED' | 'ACCEPTED' | 'AWAITING_COLLECTION' | 'COMPLETED' | 'EXECUTED' | 'FAILED' | 'FORWARDED' | 'LOCK_DECLINED' | 'LOCKED' | 'PREPARED' | 'RETURNED' | 'SETTLEMENT_DECLINED', required — State of the payment. This API only recognizes payments in the <code>LOCKED</code> state. For more on payment states, see **Payment States** in the _RippleNet Developer Guide_.<p></p>
  - `nodeAddress` string, required — RippleNet address of the participating node reporting the payment state.
  - `pathOrder` integer, required — Each node in the payment chain participates in sequence. Provides the order in the sequence in which this node participates.

## Other responses

- `400` — Bad request.
- `404` — Payment not found.

---

[API](https://skmtc.net/ripple/apis/ripplenet-server-api.md) · [All operations](https://skmtc.net/ripple/apis/ripplenet-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripplenet-server-api/versions/7843f07ca150/schema)