CustomerInterface

Base interface for customer types in the system. Implemented by both individual (IndividualPersonCustomer) and corporate (CorporateEntityCustomer) customers.

interface CustomerInterface {
  ID: ID!
  consumerID: ID
  email: String
  landline: String
  mobilePhone: String
  language: String
  address: Address!
}

Fields

CustomerInterface.ID ● ID! non-null scalar

Unique identifier for the customer in our system.

CustomerInterface.consumerID ● ID scalar

The linked customer online account ID, also returned by the Digital Onboarding createUser mutation. Use this to match an existing customer online account.

Null when no customer online account is linked, including before account creation during policy pickup. This is different from ID, which identifies the person and is used for customer lookups and offer creation in the Platform API.

CustomerInterface.email ● String scalar

Primary email address used for communication. Must be unique across all customers. Used for login and important notifications.

CustomerInterface.landline ● String scalar

Fixed-line telephone number including country code (E.164 international format)

CustomerInterface.mobilePhone ● String scalar

Mobile phone number including country code. Used for important notifications and two-factor authentication (E.164 international format)

CustomerInterface.language ● String scalar

Preferred language for communication and documents (ISO 639-1 language code).

CustomerInterface.address ● Address! non-null object

Primary postal address.

Implemented By

CorporateEntityCustomer object ● IndividualPersonCustomer object