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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.goshippo.com/feedback

```json
{
  "path": "/docs/PlatformAccounts/platform_api_migrate",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

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