PayCensus Trust API · v0.2.0

Factor lookup for machine payments

Call before you settle. Deterministic facts only — attribution, verification state, record age. No scores, no opinions. Free tier: 10 calls/day (API key required).

GET /api/status?addr={address}

curl "https://trust.paycensus.com/api/status?addr=0x1603B3A5119AA82AB1349E29f2d49B5170e085b7"

Response:

{ "addr": "0x1603…85b7", "domain": "seller.example.com", "status": "verified", "verified_at": "2026-11-07 03:40:11 UTC", "last_checked": "2026-11-07 03:40:11 UTC", "since": "2026-11-07" }

status ∈ verified · pending · revoked · none. Cached ≤60s. Revoked records keep history — see /api/revocations.

GET /api/revocations

Public append-only revocation list (the CRL of machine commerce). Cached ≤60s.

POST /api/verify/start · /api/verify/check · /api/report

Seller-side flows — used by the verify page; same contract. A report triggers an automatic re-examination; the deterministic result is the outcome. Reports are logged append-only.

API keys & metering (v0.2)

Get a key:

curl -X POST https://trust.paycensus.com/api/keys/create \ -H "Content-Type: application/json" \ -d '{"label":"my-facilitator"}'

Response (shown once, stored hashed):

{"key": "pct_live_8f14e45fceea167a5a36dedd4bea2543…"}

GET /api/factors?addr={address}

Metered factor lookup — the endpoint a facilitator or agent calls before settling. 10 calls/day free per key.

curl "https://trust.paycensus.com/api/factors?addr=0x1603B3A5119AA82AB1349E29f2d49B5170e085b7" \ -H "Authorization: Bearer pct_live_…"

Response:

{ "addr": "0x1603…85b7", "status": "verified", "domain": "seller.example.com", "since": "2026-11-07", "last_checked": "2026-11-07 13:41:08 UTC", "plan": "free", "calls_today": 1, "limit": 10 }

HTTP 429 when the daily quota is exhausted.

GET /api/usage

curl "https://trust.paycensus.com/api/usage" -H "Authorization: Bearer pct_live_…"

Today's call count and limit for your key.

Factor roadmap (v0.3)

offer_consistency (probe history), volume_percentile (census aggregates), contactability (boolean, never the address), first_seen (calendar). Composite scoring only after dispute precedent accumulates — factors before scores, always.

Terms: verification is not a guarantee · integrity · v0.2.0