---
updatedAt: 2025-11-11T23:06:51.000Z
agentTools:
  projectIndex: https://developers.shipup.co/llms.txt
---

# Address

## Example payload

```json
{
    "object": "address",
    "id": 83760,
    "address1": "3599 Winnie Summit",
    "address2": null,
    "city": "Kassulkeborough",
    "comment": null,
    "company_title": null,
    "country": "United Kingdom",
    "country_code": "GB",
    "first_name": "Shiloh",
    "last_name": "Howe",
    "name": null,
    "state": null,
    "zip": "KS2-3RT"
}
```

## Attributes

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        FIELD
      </th>

      <th>
        DESCRIPTION
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **address1**
        string
      </td>

      <td>
        Street address, including street number
      </td>
    </tr>

    <tr>
      <td>
        **address2**\
        string
      </td>

      <td>
        Optional additional field for the street address
      </td>
    </tr>

    <tr>
      <td>
        **city**\
        string
      </td>

      <td>
        City, town or village
      </td>
    </tr>

    <tr>
      <td>
        **zip**\
        string
      </td>

      <td>
        Postal code (zip, postcode, Eircode, …)
      </td>
    </tr>

    <tr>
      <td>
        **country**\
        string
      </td>

      <td>
        Country name.
      </td>
    </tr>

    <tr>
      <td>
        **country\_code**\
        string
      </td>

      <td>
        Country code. 2 letter [ISO code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) , e.g. <code>FR</code> or <code>GB</code>
      </td>
    </tr>

    <tr>
      <td>
        **state**\
        string
      </td>

      <td>
        State name. Only be there for US and CA country codes
      </td>
    </tr>

    <tr>
      <td>
        **first\_name**\
        string
      </td>

      <td>
        Address first name
      </td>
    </tr>

    <tr>
      <td>
        **last\_name**\
        string
      </td>

      <td>
        Address last name
      </td>
    </tr>

    <tr>
      <td>
        **name**\
        string
      </td>

      <td>
        Address full name
      </td>
    </tr>

    <tr>
      <td>
        **company\_title**\
        string
      </td>

      <td>
        Name of the company (for business addresses)
      </td>
    </tr>
  </tbody>
</Table>