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

# The address object

An <code>address</code> is a physical address. It can be used as a billing address, a shipping address or as the location of a delivery event.

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

      <th style={{ textAlign: "left" }}>
        DESCRIPTION
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        **address1**
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Street address, including street number
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **address2**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Optional additional field for the street address
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **city**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        City, town or village
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **zip**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Postal code (zip, postcode, Eircode, …)
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **country**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Country name. This is for presentation only and the below <code>country\_code</code> field should be provided in priority
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **country\_code**\
        string, optional, 2 letter [ISO code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), e.g. <code>FR</code> or <code>GB</code>
      </td>

      <td style={{ textAlign: "left" }}>
        Country code
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **state**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        State name. This is for presentation only and the below state\_code should be provided in priority
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **state\_code**\
        string, optional, 2 letter ISO code ([US](https://en.wikipedia.org/wiki/ISO_3166-2:US) and [CA](https://en.wikipedia.org/wiki/ISO_3166-2:CA)), e.g. <code>NY</code>
      </td>

      <td style={{ textAlign: "left" }}>
        State code (US and Canada only)
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **first\_name**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Address first name
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **last\_name**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Address last name
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **name**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Address full name
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **company\_title**\
        string, optional
      </td>

      <td style={{ textAlign: "left" }}>
        Name of the company (for business addresses)
      </td>
    </tr>
  </tbody>
</Table>