API v1.0 • MCP COMPATIBLE

Power your Agent with
The Truth Layer.

The only API that provides Verified Proof Packets for 400,000+ merchants. Reduce hallucination risk to near zero by grounding your AI in our real-time verification ledger.

Get API Keys Read Docs
GET /v1/merchant/nike/codes
// Response: 200 OK
{
"merchant": "nike.com",
"verified_count": 4,
"top_code": {
"code": "JUSTDOIT",
"health_score": 98,
"proof_packet": {
"last_verified": "2026-01-01T14:02:11Z",
"validator_id": "usr_88291",
"cart_success_rate": 0.96
}
}
}

Core Endpoints

GET /v1/merchant/{id}/codes
Rate Limit: 100/min

Returns all active verified codes for a specific merchant. Filters out expired or low-health codes (score < 50) by default to prevent agent hallucination.

?include_graveyard=true // Returns rejected codes for analysis
GET /v1/verify/packet
Rate Limit: 50/min

Returns the full forensic evidence chain for a specific code. Includes validator timestamps, screen captures (if available), and logic constraints (e.g., "New Customer Only").

POST /v1/agent/feedback
Rate Limit: 1000/min

Submit execution results (Success/Fail) from your agent back to the Truth Engine. Contributing agents receive higher rate limits and access to the "Gold" tier data.