Skip to main content

Customers Fields

Complete field reference for the customers entity.

Currency Values

All monetary amounts are stored in cents (smallest currency unit). Divide by 100 for dollar values.

FieldTypeRequiredDefaultDescription
idTextYes-Unique internal identifier (UUID)
run_idTextNo-Import batch identifier
activeBooleanNoTRUEWhether record is currently active
aliasBooleanNoFALSEWhether this is an alias record
bank_numberTextNo-Institution identifier
typeTextNo-Customer type code
customer_numberTextNo-Primary business identifier for the customer
primary_branchTextNo-Home branch number for the customer
last_nameTextNo-Customer surname (individuals)
middle_nameTextNo-Customer middle name
first_nameTextNo-Customer first name
full_nameTextNo-Complete name (computed or provided)
legal_nameTextNo-Legal entity name (businesses)
date_of_birthTimestampNo-Birth date for individuals
genderTextNo-Gender code
phone_numberTextNo-Primary phone number
phone_number_extensionIntegerNo-Phone extension if applicable
phone_number_typeTextNo-Phone type (mobile, home, work)
email_addressTextNo-Primary email address
line_1TextNo-Address line 1
line_2TextNo-Address line 2
cityTextNo-City name
stateTextNo-State or province
state_codeTextNo-State abbreviation code
state_fullTextNo-Full state name
postal_codeTextNo-ZIP or postal code
country_codeTextNo-ISO country code
countryTextNo-Country name
address_typeTextNo-Type of address (mailing, physical)
address_use_typeTextNo-Address usage classification
employee_flagBooleanNo-Whether customer is an employee
employer_nameTextNo-Name of employer
occupation_titleTextNo-Job title or occupation
corporate_nameTextNo-Business name for entities
industry_codeTextNo-NAICS or SIC code
industry_descriptionTextNo-Industry description
tinTextNo-Tax identification number (masked)
tin_typeTextNo-Original TIN type code
tin_descriptionTextNo-TIN type description
rs_tin_typeTextNo-Standardized TIN type (see Code Values)
relationship_start_dateTimestampNo-When customer relationship began
relationship_end_dateTimestampNo-When customer relationship ended
date_of_deathTimestampNo-Date of death if applicable
deceasedBooleanNoFALSEWhether customer is deceased
w9_codeTextNo-W-9 certification status
non_resident_alienBooleanNo-Non-resident alien status
credit_scoreTextNo-Credit score value
credit_score_dateTimestampNo-Date of credit score
id_typeTextNo-Original ID type code
id_type_descriptionTextNo-ID type description
rs_id_typeTextNo-Standardized ID type (see Code Values)
id_issue_dateTimestampNo-ID document issue date
id_expiry_dateTimestampNo-ID document expiration date
id_numberTextNo-ID document number (masked)
id_stateTextNo-ID issuing state
id_countryTextNo-ID issuing country
id_date_of_birthTimestampNo-Birth date from ID document
data_as_ofTimestampNo-Date the source data was extracted
partition_dateTimestampNo-Date partition for the record
updated_atTimestampNo-Last update timestamp
created_atTimestampNoCURRENT_TIMESTAMP()Record creation timestamp

This reference is generated from the schema definition.