---
title: "GET /x402/status/{paymentId}"
method: GET
path: "/x402/status/{paymentId}"
---

# GET /x402/status/{paymentId}

`GET /x402/status/{paymentId}`

## Request

- Base URL: `https://api.nano-gpt.com/api`
- URL: `https://api.nano-gpt.com/api/x402/status/{paymentId}`
- Auth: none declared

Poll the status of an X-402 payment by paymentId.

## Path parameters

- `paymentId` string, required

## Response `200`

Payment status response

- X402StatusResponse: X-402 status response for polling-based payment flows.
  - `paymentId` string
  - `status` 'pending' | 'underpaid' | 'paid' | 'processing' | 'completed' | 'failed' | 'refunded' | 'expired'
  - `amountRequired` string
  - `amountReceived` string
  - `amountRemaining` string
  - `payTo` string
  - `expiresAt` integer
  - `pollAfterSeconds` integer
  - `readyToComplete` boolean

## Other responses

- `404`: Payment not found
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/x402/status/:paymentId/get.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)