x402station.io API reference
Agent feedback: say why you did not pay
For agents that got a 402 from a paid endpoint, or a /find miss, and did not pay: say what you needed and what stopped you. The answer carries up to 3 healthy x402 endpoints for the need and, within the limits, a credit of 3 free /api/v1/preflight calls valid 24 h.
This HTML page is served by GET /api/v1/feedback. The free API operation remains POST /api/v1/feedback.
Request body
{
"blocker": "no_wallet",
"need": "translate text to German",
"route": "/api/v1/find"
}
Success response
{
"thanks": true,
"credit": {
"credit_id": "0a44f6b8-3b7d-4f2a-9e3a-2c5fd1b0aa11",
"calls": 3,
"expires_at": "2026-11-11T08:00:00.000Z",
"use": "send the header X-Credit-Id: 0a44f6b8-3b7d-4f2a-9e3a-2c5fd1b0aa11 with POST /api/v1/preflight"
},
"alternatives": [
{
"url": "https://api.example.com/v1/translate",
"score": 0.91
}
]
}
Error codes
| status | meaning |
|---|---|
400 | invalid_json, invalid_blocker, invalid_need, invalid_route or invalid_endpoint_url. |
429 | Daily limit: 5 submissions per client (IPv4 address or IPv6 /64), or the global daily cap. |
503 | Storage timeout. Nothing stored, not counted; safe to retry. |
Notes
- blocker: price, no_wallet, wrong_network, no_matching_service, unclear, other. need: 3-200 printable characters.
- One credit per client per UTC day and a global daily credit cap; when no credit is given, credit is null and credit_note says why.