Preview

CustomerUnifiedLocationItem is in Preview status and is subject to change without notice. For more information about Preview status, see the GraphQL API policy.

CustomerUnifiedLocationItem

A physical location attached to a unified (canonical) customer.

This page contains

    Fields

    id: ID!

    Stable identifier for this location row (composed of source system + location id).

    canonicalPartyId: ID!

    Canonical party identifier this location belongs to (warehouse canonical_party_id).

    sourceSystem: String

    Source system of record for the originating location row.

    sourceId: String

    Source-system identifier of the originating customer (e.g. organization id).

    locationId: String

    Source-system identifier of the location row itself.

    address: String

    Street address line 1.

    address2: String

    Street address line 2 (suite, unit, floor).

    city: String

    City.

    state: String

    State, province, or region.

    zipcode: String

    Postal or ZIP code.

    country: String

    Country.

    isPrimary: Boolean!

    True for the canonical customer's primary location. Exactly one row per canonical is primary.

    createdAt: DateTime

    Location creation timestamp from the source system (RFC 3339), when available.

    updatedAt: DateTime

    Location last-update timestamp from the source system (RFC 3339), when available.

    Parent objects of CustomerUnifiedLocationItem

    CustomerUnifiedLocationPage PREVIEW

    Cursor-paginated list of unified customer locations.

    Queries for CustomerUnifiedLocationItem

    customerUnifiedLocationListByAdvisorId PREVIEW

    Cursor-paginated list of unified customer locations for the advisor. first is capped at 100 server-side. Locations are deduped across merged source parties at the warehouse layer; the API just projects the gold rows.

    customerUnifiedLocationListByMarketplaceTenant PREVIEW

    Cursor-paginated list of unified customer locations in a marketplace tenant. Filters on the marketplace tenant column resolved through gold.party. first is capped at 100 server-side. Authorized for ROLE_CHANNEL_ADMIN only.