> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goshippo.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Shippo is a multi-carrier shipping API. For agent integrations that execute shipping operations (rates, labels, tracking, address validation, customs), connect the hosted Shippo MCP server at https://mcp.shippo.com (per-user OAuth; setup at /guides/mcp-server). To search and read this documentation from an agent, a docs search MCP is available at https://docs.goshippo.com/mcp. Shipping workflow knowledge (agent skills and a knowledge pack) is published at https://github.com/goshippo/ai. For REST integrations start at /guides/api-quickstart; test mode uses shippo_test_ API keys.

# HTTP response status codes

> Reference guide for HTTP response status codes returned by the Shippo API, from 200 OK to 5xx errors.

| Code    | Description                                                                                                                                                                        |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200/201 | OK. Everything worked as expected.                                                                                                                                                 |
| 204     | OK. Everything worked OK but no values were returned.                                                                                                                              |
| 400     | Bad request. The request you made was not accepted. This can be due to issues including missing a required parameter.                                                              |
| 401     | Unauthorized. Occurs for issues with authentication such as you didn't provide a token or the token you provided does not exist.                                                   |
| 404     | Not found. The requested resource doesn't exist.                                                                                                                                   |
| 409     | Conflict.  There was a conflict in your request. This could be caused by things like too many concurrent calls or if you tried to create a duplicate address in your address book. |
| 422     | Unprocessable entity . Your request contained content that could not be processed by the Shippo API.                                                                               |
| 429     | Rate limit exceeded. You have made too many requests to the Shippo API. See our [rates limit guide](/api-concepts/rate-limits).                                                    |
| 5xx     | Server error. Something has gone wrong with the Shippo server.                                                                                                                     |