Skip to main content

​
Error Responses

StatusMeaningRecommended Action
200SuccessProcess the response as usual.
402Payment RequiredRequest a new payment proof via x402.
429Too Many RequestsBack-off, retry later.
500Internal Server ErrorRetry after a delay, monitor status page.
503Service UnavailableTypically maintenance; retry later.

​
Example (Python)

response = requests.get(url, headers=headers)
if response.status_code == 200:
    data = response.json()
elif response.status_code == 402:
    raise Exception("Payment required – get new proof")
elif response.status_code == 429:
    sleep(60)
    retry()
else:
    raise Exception(f"Unexpected status code: {response.status_code}")