# Migrating from Platform API to Shippo API

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.

### ![](/assets/step1.14ee6260337a0b326de06f1173e3703f933b52790e666cd390788635d3e7e0a6.9c1bb791.svg) 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/`.

### ![](/assets/step2.37831ee18f1f0290fe49fb6b512319f7a374b18f4063f0302fe35b4afcd9816b.9c1bb791.svg) Reference Merchants using a header, not a parameter

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


```
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:


```
curl https://api.goshippo.com/addresses/ -H 'SHIPPO-ACCOUNT-ID: adcfdddf8ec64b84ad22772bce3ea37a'
```

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

### ![](/assets/step3.882dd6eb157abc25c1f2895637ba8769f3b55aa52288a40e94bd0d9550a670c5.9c1bb791.svg) 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](/shippoapi/public-api/shippo-accounts).
* [Carrier Own Accounts](https://platform-api-docs.goshippo.com/#tag/Carrier-Own-Accounts) has been updated to [Carrier Accounts](/shippoapi/public-api/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](/shippoapi/public-api/carrier-accounts).


### Example

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


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


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

Note
You do not need to migrate any data from your existing Platforms account.