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

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