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

# Migrating from Platform API to Shippo API

> Migrate your integration from the Shippo for Platforms API to the Shippo API with updated URLs, headers, and endpoints.

If you already use the [Shippo for Platforms API](https://goshippo.com/shippo-for-platforms/) to support your merchants, you may choose to update your integration to take advantage of the Shippo API. Follow this guide to learn how.

### Change your Base URL

Previously, Shippo for Platforms used the base URL `https://platform-api.goshippo.com`. To use the Shippo API, change your base URL to `https://api.goshippo.com/`.

### Reference Merchants using a header, not a parameter

Previously, you referenced merchants using a parameter, for example:

```shell theme={null}
curl https://platform-api.goshippo.com/merchants/{MerchantId}/addresses/
```

where `{MerchantId}` is the object ID of your merchant.

To use Managed Shippo Accounts in the Shippo API, you reference your Managed Account merchant using a header element. For example:

```shell theme={null}
curl https://api.goshippo.com/addresses/ -H 'SHIPPO-ACCOUNT-ID: adcfdddf8ec64b84ad22772bce3ea37a'
```

where `SHIPPO-ACCOUNT-ID` is the object ID of your Managed Account merchant.

### Renamed endpoints

The following endpoints have changed. Follow the examples in our reference documentation to update your integration.

* [Merchant](https://platform-api-docs.goshippo.com/#tag/Merchants) has been updated to [Shippo Accounts](/api-reference/shippo-accounts/list-all-shippo-accounts).
* [Carrier Own Accounts](https://platform-api-docs.goshippo.com/#tag/Carrier-Own-Accounts) has been updated to [Carrier Accounts](/api-reference/carrier-accounts/list-all-carrier-accounts).
* [Shippo Carrier Accounts](https://platform-api-docs.goshippo.com/#tag/Carrier-Master-Accounts) has been updated and is now part of [Carrier Accounts](/api-reference/carrier-accounts/list-all-carrier-accounts).

### Example

To list all the address stored in a merchant's account

```shell Shippo API theme={null}
curl https://api.goshippo.com/addresses/ \
  -H 'Authorization: ShippoToken <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -H 'SHIPPO-ACCOUNT-ID: <ShippoAccountID>'
```

```shell Platform API theme={null}
curl https://platform-api.goshippo.com/merchants/{MerchantId}/addresses/ \
  -H 'Authorization: ShippoToken <API_TOKEN>' \
  -H 'Content-Type: application/json'
```

<Info>
  **Note**

  You do not need to migrate any data from your existing Platforms account.
</Info>


## Related topics

- [Shippo API release notes](/api-concepts/api-change-log.md)
- [Business Cases for the Shippo API](/partner-integration/business-cases.md)
- [Shippo API Integration Guide](/partner-integration/intro.md)