Skip to main content

Get customer

GET 
/Customer/:customerCode

Get customer

Request​

Path Parameters

    customerCode stringrequired

    The customer code.

Responses​

The customer with the specified customer code.

Schema
    customerCode stringnullablerequired

    The unique code identifying the customer.

    customerTypeCode stringnullablerequired

    The code identifying the customer's type classification.

    customerLegalTypeCode stringnullablerequired

    The code identifying the customer's legal entity type.

    lastname stringnullablerequired

    The customer's primary last name.

    lastname2 stringnullablerequired

    The customer's secondary or maiden last name.

    middleName stringnullablerequired

    The customer's middle name.

    firstname stringnullablerequired

    The customer's first name.

    fatherName stringnullablerequired

    The customer's father's name.

    motherName stringnullablerequired

    The customer's mother's name.

    birthDate date-timenullablerequired

    The customer's date of birth.

    gender int32nullablerequired

    The customer's gender (numeric code).

    mobilePhone1 stringnullablerequired

    The customer's primary mobile phone number.

    mobilePhone2 stringnullablerequired

    The customer's secondary mobile phone number.

    emailAddress1 stringnullablerequired

    The customer's primary email address.

    emailAddress2 stringnullablerequired

    The customer's secondary email address.

    taxCode stringnullablerequired

    The customer's tax identification number.

    taxOfficeCode stringnullablerequired

    The code of the tax office where the customer is registered.

    dependentMembers int32nullablerequired

    The number of dependent family members.

    educationLevelCode stringnullablerequired

    The code identifying the education level.

    originCityName stringnullablerequired

    The name of the customer's city of origin.

    originCountryCode stringnullablerequired

    The ISO country code of the origin country.

    nationalityCountryCode stringnullablerequired

    The ISO country code of the customer's nationality.

    teiresiasType stringnullablerequired

    The Tiresias (credit bureau) classification type for the customer.

    activeDate date-timenullablerequired

    The date when the customer record was activated.

    deactivationDate date-timenullablerequired

    The date when the customer record was deactivated.

    customerBranchCode stringnullablerequired

    The code of the branch that owns this customer record.

    customerWatchingBranchCode stringnullablerequired

    The code of the branch responsible for monitoring this customer.

    customerStatusCode stringnullablerequired

    The code representing the customer's current status.

    customerKycDate date-timenullablerequired

    The date of the customer's most recent Know Your Customer (KYC) review.

    customerRegistrationNumber stringnullablerequired

    The customer's official registration number.

    customerDisabilities stringnullablerequired

    Information about any disabilities recorded for the customer.

    customerTaxResidentPlace int32nullablerequired

    The numeric identifier of the customer's tax residence location.

    onBoardingStatusCode stringnullablerequired

    The code representing the customer's onboarding status.

    onBoardingStatusTitle stringnullablerequired

    The display title of the customer's onboarding status.

    bussinessTypeTitle stringnullablerequired

    The display title of the customer's business type.

    bussinessTypeCode stringnullablerequired

    The code identifying the customer's business type.

    customerBussinessTypeCode stringnullablerequired

    The code identifying the customer's business type.

    customerBussinessTypeTitle stringnullablerequired

    The display title of the customer's business type.

    birthPlaceCityCode stringnullablerequired

    The code of the city where the customer was born.

    birthPlaceCityName stringnullablerequired

    The name of the city where the customer was born.

    custCodeOriginal stringnullablerequired

    The customer's original code before any code migration or update.

    taxResidenceResponse object

    The customer's tax residence details.

    recidenceTitle stringnullablerequired

    The display title of the tax residence.

    createdBy stringnullablerequired

    The username or identifier of the user who created this record.

    createdAt date-timenullablerequired

    The date and time when this record was created.

    updatedBy stringnullablerequired

    The username or identifier of the user who last updated this record.

    updatedAt date-timenullablerequired

    The date and time when this record was last updated.

    customerRelations object[]nullable

    The list of relationships associated with this customer.

  • Array [
    • relationID int32required

    The numeric identifier of the customer relationship.

    relationDescription stringnullablerequired

    A textual description of the relationship type.

  • ]
    • customerYearIncomes object[]nullable

    The list of yearly income records for this customer.

  • Array [
    • fiscalYear int32nullablerequired

    The fiscal year for which the income is reported.

    yearIncome doublenullablerequired

    The total annual income amount.

    incomeTypeCode stringnullablerequired

    The code identifying the type of income.

    incomeTypeTitle stringnullablerequired

    The display title of the income type.

    createInfo object

    Audit metadata capturing who created this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

    updateInfo object

    Audit metadata capturing who last updated this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

  • ]
    • customerAmlCode stringnullablerequired

    The AML-specific code assigned to the customer.

    customerTypeTitle stringnullablerequired

    The display title of the customer type.

    customerLegalTypeTitle stringnullablerequired

    The display title of the customer's legal entity type.

    taxOfficeTitle stringnullablerequired

    The display title of the tax office.

    educationLevelTitle stringnullablerequired

    The display title of the education level.

    originCountryName stringnullablerequired

    The display name of the customer's country of origin.

    nationalityCountryName stringnullablerequired

    The display name of the customer's nationality country.

    customerBranchTitle stringnullablerequired

    The display title of the branch that owns this customer record.

    customerWatchingBranchTitle stringnullablerequired

    The display title of the branch responsible for monitoring this customer.

    customerStatusTitle stringnullablerequired

    The display title of the customer status.

    custRiskLevelCode int32required

    The risk level code assigned to the customer.

    riskLevelCodeComputeMode booleanrequired

    The computation mode used for the risk level code.

    amlFlag booleanrequired

    The AML flag status of the customer.

    reportToAuthorities booleanrequired

    Indicates whether this customer should be reported to regulatory authorities.

    reportToAuthoritiesDate date-timenullablerequired

    The date when the customer was reported to authorities.

    amlCustDateUpdated date-timerequired

    The date when the customer's AML record was last updated.

    foundInSanctionLists string[]nullablerequired

    Indicates whether the customer was found in any sanction list.

    foundInPepLists string[]nullablerequired

    Indicates whether the customer was found in any PEP list.

    customerAddresses object[]nullable

    The list of addresses associated with this customer.

  • Array [
    • id int32required

    The unique identifier of this record.

    correlationKey stringnullablerequired

    A unique key used to correlate related records across operations.

    addressTypeCode stringnullablerequired

    The code identifying the type of address (e.g., home, work).

    line1 stringnullablerequired

    The first line of the address.

    line2 stringnullablerequired

    The second line of the address.

    line3 stringnullablerequired

    The third line of the address.

    postCode stringnullablerequired

    The postal or ZIP code.

    cityName stringnullablerequired

    The name of the city.

    provinceName stringnullablerequired

    The name of the province or region.

    countryCode stringnullablerequired

    The unique country code.

    telephone stringnullablerequired

    The telephone number associated with this address.

    activeFrom date-timenullablerequired

    The date from which this record is active.

    activeTo date-timenullablerequired

    The date until which this record is active.

    isMain booleannullablerequired

    Indicates whether this is the primary or main record.

    addressTypeTitle stringnullablerequired

    The display title of the address type.

    countryName stringnullablerequired

    The display name of the country.

    createInfo object

    Audit metadata capturing who created this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

    updateInfo object

    Audit metadata capturing who last updated this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

  • ]
    • customerIdentities object[]nullable

    The list of identity documents associated with this customer.

  • Array [
    • id int32required

    The unique identifier of this record.

    correlationKey stringnullablerequired

    A unique key used to correlate related records across operations.

    identityTypeCode stringnullablerequired

    The code identifying the type of identity document.

    identityNumber stringnullablerequired

    The identity document number.

    issueCountryCode stringnullablerequired

    The ISO country code of the country that issued the identity document.

    issueCityName stringnullablerequired

    The name of the city where the identity document was issued.

    issueProvinceName stringnullablerequired

    The name of the province where the identity document was issued.

    issueDate date-timenullablerequired

    The date when the identity document was issued.

    expirationDate date-timenullablerequired

    The expiration date of the identity document.

    identityTypeTitle stringnullablerequired

    The display title of the identity document type.

    issueCountryName stringnullablerequired

    The name of the country that issued the identity document.

    isExpired booleannullablerequired

    Indicates whether the identity document has expired.

    createInfo object

    Audit metadata capturing who created this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

    updateInfo object

    Audit metadata capturing who last updated this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

  • ]
    • customerProfessions object[]nullable

    The list of professions associated with this customer.

  • Array [
    • id int32required

    The unique identifier of this record.

    professionCode stringnullablerequired

    The code identifying the profession.

    activeFrom date-timenullablerequired

    The date from which this record is active.

    activeTo date-timenullablerequired

    The date until which this record is active.

    professionTitle stringnullablerequired

    The display title of the profession.

    createInfo object

    Audit metadata capturing who created this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

    updateInfo object

    Audit metadata capturing who last updated this record and when.

    actionBy stringnullablerequired

    The username or identifier of the user who performed the action.

    actionAt date-timerequired

    The date and time when the action was performed.

  • ]
Loading...