> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meld.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Finicity Owners Mapping

This data comes from Finicity's [/aggregation/v1/customers /`{customerId}`/accounts /`{accountId}`/owner](https://api-reference.finicity.com/#/rest/api-endpoints/account-owner/get-account-owner) endpoint and is returned from Meld's [/bank-linking/accounts](/api-reference/bank-linking/accounts/bank-linking-accounts-search) endpoint.

<Note>
  Example values: `names: ["Jane Doe"]`, `addresses.data.full: "123 Main St, Springfield, IL 62701"`.
</Note>

<Warning>
  Finicity returns owner address as a single unparsed string in `ownerAddress`, mapped to `addresses.data.full`. Parsed sub-fields (`street`, `city`, `region`, `postalCode`, `country`) are not provided. Email and phone number data are also not provided.
</Warning>

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

      <th style={{ textAlign: "left" }}>
        Description
      </th>

      <th style={{ textAlign: "left" }}>
        Finicity Response Field
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        addresses
      </td>

      <td style={{ textAlign: "left" }}>
        The address(es) associated with this owner
      </td>

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

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

      <td style={{ textAlign: "left" }}>
        The address data object
      </td>

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

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

      <td style={{ textAlign: "left" }}>
        The street and residence number
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The city
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The region/state
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The postal or zip code
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The ISO 3166-1 alpha-2 country code
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The full unparsed address
      </td>

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

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

      <td style={{ textAlign: "left" }}>
        Indicates if this is the owner's primary residence
      </td>

      <td style={{ textAlign: "left" }}>
        Does not provide.<br />Meld will\
        default\
        to`Primary.UNKNOWN`
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The email(s) associated with this owner
      </td>

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

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

      <td style={{ textAlign: "left" }}>
        The email address
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        Indicates if this is the owner's primary email
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        The name(s) of this owner
      </td>

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

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

      <td style={{ textAlign: "left" }}>
        The phone number(s) associated with this owner
      </td>

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

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

      <td style={{ textAlign: "left" }}>
        The phone number
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>

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

      <td style={{ textAlign: "left" }}>
        Indicates if this is the owner's primary phone number
      </td>

      <td style={{ textAlign: "left" }}>
        *None*
      </td>
    </tr>
  </tbody>
</Table>