> ## 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. |


## Related topics

- [Reporting API overview](/reporting-api/overview.md)
- [Core Concepts](/reporting-api/concepts.md)
- [Create and poll a report run](/reporting-api/create-and-poll.md)