---
title: "Poll (or long-poll) a payment session"
method: GET
path: "/api/payment-status/{sessionId}"
tags: ["Payment (x402)"]
---

# Poll (or long-poll) a payment session

`GET /api/payment-status/{sessionId}`

## Path parameters

- `sessionId` string, required

## Query parameters

- `wait` boolean

## Response `200`

Payment session state

- PaymentStatus
  - `session_id` string, required
  - `status` 'pending' | 'completed' | 'failed' | 'expired', required
  - `amount` string, required — Amount as string to avoid float precision
  - `asset` string, required
  - `network` string, required
  - `pay_to` string, required — Wallet address to pay
  - `created_at` string, date-time, required
  - `expires_at` string, date-time
  - `capture_url` string, uri — Human-facing payment URL
  - `payer` string — Payer wallet address, set on completion.
  - `tx_hash` string — On-chain transaction hash (when `status = completed`).
  - `completed_at` string, date-time

## Other responses

- `404` — Session not found or expired

## Changes

- **2026-04-21** `8a22dc180044` — 4 breaking, 2 warning, 7 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the media type `application/json` for the response with the status `404`
  - removed the required property `sessionId` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - …9 more

[Change history](https://skmtc.dev/getbindu/apis/bindu-agent-api/changes/api/payment-status/:sessionId/get.md)

---

[API](https://skmtc.dev/getbindu/apis/bindu-agent-api.md) · [All operations](https://skmtc.dev/getbindu/apis/bindu-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbindu/bindu-agent-api/revisions/e070faa5425b/schema)