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.

Signature
POST /api/v1/feedback
Pricing
free (no PAYMENT-SIGNATURE)
Settlement
none (free route)
Canonical
https://x402station.io/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

statusmeaning
400invalid_json, invalid_blocker, invalid_need, invalid_route or invalid_endpoint_url.
429Daily limit: 5 submissions per client (IPv4 address or IPv6 /64), or the global daily cap.
503Storage timeout. Nothing stored, not counted; safe to retry.

Notes

Machine-readable links