# Getting a customer by Id.

Endpoint: GET /api/external/v1/customers/{customer-id}
Version: v1

## Path parameters:

  - `customer-id` (string, required)
    Customer id.

## Response 200 fields (application/json):

  - `errorMessageCodes` (array,null)

  - `errors` (array,null)

  - `errors.code` (string,null)

  - `errors.message` (string,null)

  - `errors.field` (string,null)

  - `data` (object)

  - `data.id` (string)

  - `data.firstname` (string,null)

  - `data.lastname` (string,null)

  - `data.institutionId` (string)

  - `data.institutionName` (string,null)

  - `data.salutation` (string,null)

  - `data.type` (string)
    Enum: "Unknown", "Person", "LegalEntity"

  - `data.birthDate` (string,null)

  - `data.title` (string,null)

  - `data.email` (string,null)

  - `data.phoneNumber` (string,null)

  - `data.walletAccess` (string)
    Enum: "None", "Basic", "Full"

  - `data.address` (object)

  - `data.address.street` (string,null)

  - `data.address.streetNo` (string,null)

  - `data.address.postalCode` (string,null)

  - `data.address.town` (string,null)

  - `data.address.country` (object)

  - `data.address.country.iso` (string,null)

  - `data.address.country.isoCode3` (string,null)

  - `data.address.country.name` (string,null)

  - `data.address.countryCode` (string,null)

  - `data.nationalityId` (string,null)

  - `data.nationalityIso` (string,null)

  - `data.gender` (string)
    Enum: "NotSet", "Male", "Female", "Other"

  - `data.kycData` (object)

  - `data.kycData.title` (string,null)
    Title such as "Dr.", "Prof.", etc.

  - `data.kycData.salutation` (string,null)
    Salutation such as "Herr", "Frau", "Mr.", "Ms.", etc.

  - `data.kycData.firstname` (string, required)
    First name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `data.kycData.lastname` (string, required)
    Last name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `data.kycData.placeOfBirth` (string, required)
    Place of birth denoted in the used identification document of the investor.

  - `data.kycData.dateOfBirth` (string, required)
    Date of birth is a regulatory requirement for the KYC process.

  - `data.kycData.email` (string, required)
    The email which the investor used to register. You can re-use the same input as from customer creation.

  - `data.kycData.phoneNumber` (string,null)
    Phone number of the investor.

  - `data.kycData.nonPepPerson` (boolean, required)
    Relates to the political exposure of the person. Indicates whether the person is NOT a Politically Exposed Person (PEP).

  - `data.kycData.highCorruptionIndex` (boolean, required)
    Relates to the country of residence. You can always send "false" if your KYC provider performs these checks automatically.

  - `data.kycData.nonSanctionedCountry` (boolean, required)
    Indicates the investor is NOT residing in a sanctioned country. You can always send "true" if your KYC provider performs these checks automatically.

  - `data.kycData.nonUsTaxPerson` (boolean, required)
    We do not accept persons subjected to US tax. Always set to "true" (if the person is not subject to taxes in the USA).

  - `data.kycData.identVerified` (boolean, required)
    Only send KYC data of customers that have been verified already. Hence, always set this field to "true".

  - `data.kycData.identVerifiedType` (string)
    Enum: "NotSet", "Normal", "Plain"

  - `data.kycData.tanganyIdentVerifiedType` (string)
    Enum: "Video_ident", "Id_copy", "Auto_ident", "In_person", "Eid", "Post_ident", "Qes_bankident"

  - `data.kycData.eulaAgreed` (boolean, required)
    Refers to the Smart Registry terms of use. Ensure that your end users always have to agree to the terms as part of their onboarding process, then always set to "true".

  - `data.kycData.company` (object)
    Only required when the account type is LegalEntity.

  - `data.kycData.company.registerNumber` (string, required)

  - `data.kycData.company.fullAddress` (string, required)

  - `data.kycData.nationalityIso` (string,null)
    The nationality ISO of the investor. Use ISO 3166-1 alpha-2 country codes.

  - `data.kycData.tanganyLegalPerson` (object)

  - `data.kycData.tanganyLegalPerson.id` (string,null)
    Not required in case of creating new Tangany legal person

  - `data.kycData.tanganyLegalPerson.name` (string, required)
    The name of the company. You can re-use the value from company.name.

  - `data.kycData.tanganyLegalPerson.legalForm` (string, required)
    Legal form of company. E.g. "AG", "GmbH".

  - `data.kycData.tanganyLegalPerson.commercialRegister` (string,null)
    You may leave it blank. Legally speaking, only the register number is required.

  - `data.kycData.tanganyLegalPerson.leiCode` (string,null)
    LEI code of the company.

  - `data.kycData.tanganyLegalPerson.taxId` (string,null)
    Tax ID of the company.

  - `data.kycData.tanganyLegalPerson.vatId` (string,null)
    Vat ID of the company.

  - `data.kycData.tanganyLegalPerson.isinCode` (string,null)
    ISIN code of the company.

  - `data.kycData.tanganyLegalPerson.legalJurisdiction` (string,null)
    ISO country code (e.g. "DE") where the legal entity is registered. Not mandatory, as this data is captured within the legalAddress object.

  - `data.kycData.tanganyLegalPerson.legalAddress` (object, required)

  - `data.kycData.tanganyLegalPerson.legalAddress.country` (string, required)
    ISO country code (e.g. "DE") where the company is registered.

  - `data.kycData.tanganyLegalPerson.legalAddress.city` (string, required)
    City where company is registered.

  - `data.kycData.tanganyLegalPerson.legalAddress.postcode` (string, required)
    Post code where company is registered.

  - `data.kycData.tanganyLegalPerson.legalAddress.streetName` (string, required)
    Street name where company is registered.

  - `data.kycData.tanganyLegalPerson.legalAddress.streetNumber` (string, required)
    Street number where company is registered.

  - `data.kycData.tanganyLegalPerson.postalAddress` (object)

  - `data.kycData.tanganyLegalPerson.kyc` (object)

  - `data.kycData.tanganyLegalPerson.kyc.businessDescription` (string, required)
    You can always send the following value: "Investor".

  - `data.kycData.tanganyLegalPerson.kyc.isCreAvailable` (boolean, required)
    You can always set this field to false.

  - `data.kycData.tanganyLegalPerson.related` (array, required)

  - `data.kycData.tanganyLegalPerson.related.entityId` (string,null)
    The legal requirement is to create one per beneficial owner of the company (even if they do not have to go through the KYC process).

  - `data.kycData.tanganyLegalPerson.related.position` (string,null)
    Position of the beneficial owner in the company.

  - `data.kycData.tanganyLegalPerson.related.isFictitiousBeneficialOwner` (boolean, required)
    Indicates if this is a fictitious beneficial owner.

  - `data.kycData.tanganyLegalPerson.related.isUltimateBeneficialOwner` (boolean, required)
    Indicates if this is the ultimate beneficial owner.

  - `data.kycData.tanganyLegalPerson.related.sharePercentage` (string,null)
    Share percentage of ownership.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson` (object)

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.id` (string, required)
    Customer ID received after creating a customer in NYALA's system.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.firstName` (string, required)
    First name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.lastName` (string, required)
    Last name of the investor. When sending values with accents (e.g. É, ç, ñ), send the values in UTF-8 charset.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.birthDate` (string, required)
    Date of birth is a regulatory requirement for the KYC process.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.birthPlace` (string, required)
    Place of birth denoted in the used identification document of the investor.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.title` (string,null)
    Titles such as "Dr.", "Prof.", etc.

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.birthCountry` (string,null)
    Country of birth using two-letter country code (ISO 3166-1 alpha-2)

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.birthName` (string,null)

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.nationality` (string,null)
    ISO country codes (e.g. "DE").

  - `data.kycData.tanganyLegalPerson.related.naturalPerson.selfDeclaredAsPep` (boolean)
    Indicates whether the investor has self-declared as a Politically Exposed Person (PEP).

  - `data.kycData.tanganyLegalPerson.related.legalPerson` (object)

  - `data.approvedForMonerium` (boolean,null)

  - `data.moneriumIban` (string,null)

  - `data.tanganyCustomerId` (string,null)

  - `data.tanganyAuthorizedId` (string,null)

  - `data.tanganyOwnerId` (string,null)

  - `data.hadcCustomerId` (string,null)