Skip to content

Errors

Errors come back as tool errors with a plain-language message, and never include your credentials.

Message Cause Fix
error 401 … (check REQUEST_API_KEY / REQUEST_CLIENT_ID) Missing or invalid credentials Re-copy your Client ID or API key. If your Client ID is domain-restricted, set REQUEST_ORIGIN.
error 403 … Client ID revoked or origin not allowed Generate a new Client ID or fix the allowed domain.
error 404 … (no invoice with that ID) Wrong invoice ID Use list_invoices to find it.
error 400: … The API rejected an input, e.g. an unknown currency Read the detail; use find_currency for IDs.
error 429 … (rate limited) Too many requests Wait a few seconds.
No receiving route configured No route set Copy a Route ID from the dashboard into REQUEST_DESTINATION_ID or REQUEST_ROUTES.
No route takes … / No route on … You asked for a currency or network you have no route for Add a route for it, or pick one from the list in the message.
More than one route matches e.g. USDC on two networks Say which network.
API could not be reached / timed out Network problem Check your connection and retry.