---
name: read-payment-check
description: Did a Keeta payment settle? Who paid whom, how much, and the network fee when the ledger shows one, with an optional yes or no receipt match. From the ledger. Not a spendable receipt. 0.01 USDC. Not free while payments are down: that call returns 503.
---

# Payment check

## When to use

Use when you have a Keeta transaction hash, for example the transaction field of an x402 settle reply, and need to know whether it settled and who paid whom. Pass to, amountBase and asset when you expect a specific payment. For the raw block, use the free /api/block.

## Request

GET https://keespecs.xyz/api/payment-check?hash={hash}. Optional: &to={to}&amountBase={amountBase}&asset={asset}. 0.01 USDC. hash is 64 hex characters with no 0x. to and asset are keeta_ addresses with a valid checksum. amountBase is a ledger integer. A missing or malformed query returns 400 and is not charged. A hash that is not on the ledger returns 200 with status not_on_ledger and is not charged. While payments are down, this call returns 503. A missing payment returns 402.

## Fields

- settled is true when the hash is a block on Keeta mainnet. A vote staple or a network fee is not required.
- sends lists every send in that block and in the other blocks of its vote staple: from, to, asset, code, decimals, amountBase, amount, and block.
- amountBase is the ledger integer. amount is that integer scaled by decimals, for reading only. It is null when decimals are unknown.
- match appears only when you pass to, amountBase or asset. match.ok is true when one send matches every field you passed. amountBase is compared as an exact integer, so 10000 and 010000 match.
- payment is the matching send, or the queried block's only send when you passed no receipt. Otherwise it is null.
- network_fee comes from the fee field on the staple's votes. When the votes have no fee field, amountBase is null and why says so. payer is the account of the staple's fee block when there is one.
- note is: From the Keeta ledger as of asOf. Whether this hash settled. Not a spendable receipt.

Catalogue: https://keespecs.xyz/apis
Skills: https://keespecs.xyz/skills
Sending, bridging, banks, cards, and identity: https://keeta.ai/llms.txt
