Skip to main content
GET
Look up a single claim
The response body shown here is a static example, not live data. After you click Send, your live result appears in a separate panel headed 200 OK. The panel under the status-code tabs is a fixed sample from the spec — its field values (fees, prices, sizes, IDs, timestamps) are placeholders. Use Send, or call the endpoint, for current values.
Returns a single claim row identified by (address, id). Both parameters are required — claims are partitioned by affiliate in the datastore, so a global id-only lookup is not supported.

Query Parameters

address
string
required

Affiliate address that submitted the claim. 20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase af after 0x.

Pattern: ^(0x|0X)?[0-9a-fA-F]{40}$
id
string
required

Claim identifier (matches the on-chain transferId).

Minimum string length: 1

Response

The claim row.

affiliate
string
required

Lower-case 0x-prefixed 20-byte affiliate address.

timestampUs
integer<int64>
required

Wall-clock microsecond timestamp the claim was processed.

claimId
string
required

Opaque identifier of the claim (matches on-chain transferId).

cutoffFillId
integer<int64>
required

Opaque monotonic referral cutoff recorded with the claim. For claims submitted through POST /v1/affiliate/claim, this is server-computed from the latest referral event state and is used only for idempotency/stale-claim detection; clients should not interpret it as a selectable fill-id range.

amountQuantums
integer<int64>
required

Total claim amount in quote quantums (1e9 = $1).