> For the complete documentation index, see [llms.txt](https://docs.native.org/native-dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.native.org/native-dev/build-with-native/swap-aggregators/crosschain-swap-api/miscellaneous/error-handling.md). # Error Handling ## Error Handling Requests with application or business logic errors will return with an HTTP code of 200, but with additional fields for error code and message. For example: ```json { "code": 171008, "message": "Internal Server Error" } { "code": 171018, "message": "expire time exceeds global limit 120s" } ``` To verify the response status, please check `success` bool, or if `code` is present in the response. {% hint style="info" %} Please note that for endpoints that typically return an array, when they encounter an error, the response will be in object format. {% endhint %} ## Error Codes The list of most common error codes returned by CrossChain Swap APIs. For other unknown errors, please reach out to Native team members via an existing channel.
CodeMessageReasonMitigation
351015requested amount smaller than token out minimum wei [xxx]The buying (bridge to) token amount is too small.Check /pages/UTe7r4fKUplVM0Sgyl5W for the minimum amount and avoid bridging orders that are too small.
351003unable to bridge: insufficient bridging liquidityThe quote request exceeds the maximum available bridging liquidity at the moment.This is expected to be common (non-error) for upstreams that quote optimistically.

Simply try again later, and ensure this will not trick circuit breakers.
131003failed to parse parametersIssues with input parameters. Usually due to incorrect formats.Check input format. Avoid passing floats in unsupported params like amount_wei or timeout_millis
131004invalid parameterIssues with input parameters. Usually due to input conflicts or missing params.Check the related API reference to see if any param is duplicated or missing.
201001auth get api key is invalidAuth error.Use correct api key.
201005rate reach limitRate limit is hit.Reduce traffic.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.native.org/native-dev/build-with-native/swap-aggregators/crosschain-swap-api/miscellaneous/error-handling.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.