> ## 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. # Upgrading from v20161025 to v20180208 > Review deprecated and added fields when upgrading from Shippo API v20161025 to v20180208. If you have already integrated with the Shippo API v20161025 and are now planning to upgrade to the latest version (v20180208), you can use this guide to identify which objects have changed between versions. In these tables you will find the fields within each object have that have deprecated. In some cases, you can see a replacement field that has been added in v20180208. ## Deprecated ◎ and added ◉ fields ### Orders | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ---------- | ---------------------------------- | ------------------------------- | | **Orders** | address\_from | from\_address | | | created\_at | | | | hidden | | | | items | | | | to\_address.ip | | | | to\_address.messages | | | | to\_address.object\_purpose | | | | to\_address.object\_source | | | | to\_address.object\_state | | | | | placed\_at | | | | test | | | | to\_address.is\_complete | | | | to\_address.validation\_results | | | | | ### Batches | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ----------- | ---------------------------------- | --------------------------- | | **Batches** | object\_status | status | | | | | ### Carrier Accounts | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | -------------------- | ---------------------------------- | --------------------------- | | **Carrier Accounts** | | carrier\_images | | | | carrier\_images.300 | | | | carrier\_images.425 | | | | carrier\_name | | | | | ### Manifests | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ------------- | ---------------------------------- | --------------------------- | | **Manifests** | is\_test | | | | object\_status | status | | | submission\_date | | | | | shipment\_date | | | | | ### Refund | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ---------- | ---------------------------------- | --------------------------- | | **Refund** | object\_status | status | | | | | ### Customs Declarations | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ------------------------ | ---------------------------------- | --------------------------- | | **Customs Declarations** | | address\_importer | | | | b13a\_filing\_option | | | | b13a\_number | | | | duties\_payor | | | | exporter\_identification | | | | invoiced\_charges | | | | is\_vat\_collected | | | | | ### Customs Items | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ----------------- | ---------------------------------- | --------------------------- | | **Customs Items** | | eccn\_ear9 | | | | | ### Tracks | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ---------- | ---------------------------------- | --------------------------- | | **Tracks** | | tracking\_status.substatus | | | | substatus.text | | | | substatus.code | | | | substatus.action\_required | | | | description | | | | | ### Transactions | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ---------------- | ---------------------------------- | --------------------------- | | **Transactions** | customs\_note | | | | notification\_email\_from | | | | notification\_email\_other | | | | notification\_email\_to | | | | object\_status | status | | | pickup\_date | | | | submission\_note | | | | tracking\_history | | | | was\_test | test | | | | billing.payments | | | | billing | | | | qr\_code\_url | | | | | ### Rates | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | --------- | ---------------------------------- | --------------------------------- | | **Rates** | available\_shippo | | | | days | estimated\_days | | | delivery\_attempts | | | | inbound\_endpoint | | | | insurance | | | | insurance\_amount | | | | insurance\_amount\_local | | | | insurance\_currency | | | | insurance\_currency\_local | | | | object\_purpose | | | | object\_state | | | | object\_updated | | | | outbound\_endpoint | | | | servicelevel\_name | servicelevel.name | | | servicelevel\_terms | servicelevel.terms | | | servicelevel\_token | servicelevel.token | | | trackable | | | | | servicelevel.extended\_token | | | | servicelevel.parent\_servicelevel | | | | included\_insurance\_price | | | | servicelevel | | | | | ### Shipments | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ------------- | ---------------------------------- | ----------------------------------- | | **Shipments** | insurance\_amount | | | | insurance\_currency | | | | object\_purpose | | | | object\_state | | | | object\_status | | | | parcel | | | | rates\_list | | | | rates\_url | | | | reference\_1 | | | | reference\_2 | | | | return\_of | | | | submission\_date | | | | submission\_type | | | | | address\_from.is\_complete | | | | address\_from.validation\_results | | | | address\_from.name | | | | address\_from.street3 | | | | address\_from.zip | | | | address\_from.city | | | | address\_from.state | | | | address\_from.test | | | | address\_from.object\_id | | | | status | | | | address\_to.is\_complete | | | | address\_from.company | | | | address\_from.is\_residential | | | | address\_from.email | | | | address\_from.country | | | | address\_from.phone | | | | address\_from.street2 | | | | address\_from.street1 | | | | address\_from.street\_no | | | | address\_to.object\_id | | | | address\_return.city | | | | address\_return.company | | | | address\_return.country | | | | address\_return.email | | | | address\_return.is\_complete | | | | address\_return.is\_residential | | | | address\_return.name | | | | address\_return.object\_id | | | | address\_return.phone | | | | address\_return.state | | | | address\_return.street1 | | | | address\_return.street2 | | | | address\_return.street3 | | | | address\_return.street\_no | | | | address\_return.test | | | | address\_return.validation\_results | | | | address\_return.zip | | | | address\_to.city | | | | address\_to.company | | | | address\_to.country | | | | address\_to.email | | | | address\_to.is\_residential | | | | address\_to.name | | | | address\_to.phone | | | | address\_to.state | | | | address\_to.street1 | | | | address\_to.street2 | | | | address\_to.street3 | | | | address\_to.street\_no | | | | address\_to.test | | | | address\_to.validation\_results | | | | address\_to.zip | | | | alternate\_address\_to | | | | rates | | | | parcels | | | | shipment\_date | | | | | ### Addresses | Resource | Deprecated fields from v20161025 ◎ | Fields added in v20180208 ◉ | | ------------- | ---------------------------------- | --------------------------- | | **Addresses** | ip | | | | messages | | | | object\_purpose | | | | object\_source | | | | object\_state | | | | | is\_complete | | | | validation\_results | ## Updated fields ◐ The following object fields have changed type in v20180208 since v20161025: | Resource | Field | Field type in v20161025 | Field type changed to in v20180208 | | ---------------- | ---------------- | ----------------------- | ---------------------------------- | | **Orders** | weight | int | decimal | | **Transactions** | tracking\_status | obj | str | | **Shipments** | address\_from | str | Obj or address object id as a str | | | address\_to | str | Obj or address object id as a str | | | address\_return | str | Obj or address object id as a str | ## Related topics - [Upgrading from v20140211 to v20180208](/api-concepts/api-upgrade-guides/v20140211-to-2018.md) - [Upgrading from v20170329 to v20180208](/api-concepts/api-upgrade-guides/v20170329-to-2018.md) - [Upgrading from v20170801 to v20180208](/api-concepts/api-upgrade-guides/v20170801-to-2018.md)