---
title: "Check payment status"
method: GET
path: "/status/{payment_id}"
tags: ["x402 Core"]
---

# Check payment status

`GET /status/{payment_id}`

## Request

- Base URL: `https://x402-agent-pay.com`
- URL: `https://x402-agent-pay.com/status/{payment_id}`
- Auth: none declared

Look up the on-chain settlement status of any payment by ID.

## Path parameters

- `payment_id` string, required

## Response `200`

Payment status

- PaymentStatus
  - `payment_id` string
  - `status` 'pending' | 'confirmed' | 'failed'
  - `tx_hash` string
  - `amount_usdc` number
  - `settled_at` string, date-time

## Other responses

- `402`: Payment Required — attach X-PAYMENT header with EIP-712 signed USDC grant
- `404`: Payment not found

---

[API](https://skmtc.dev/x402-agent-pay/apis/agentpay-x402-facilitator-api.md) · [All operations](https://skmtc.dev/x402-agent-pay/apis/agentpay-x402-facilitator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/x402-agent-pay/apis/agentpay-x402-facilitator-api/revisions/33ece6814ac9?raw)