Skip to main content

Client

Represents a client.

activationDatestring<date-time>

The date when a client was set as active for the first time.

Example: 2016-09-06T13:37:50+03:00
addresses object[]

The addresses associated with this client.

  • Array [
  • citystring

    The city for the address.

    countrystring

    The country.

    encodedKeystring

    The address encoded key, which is unique and generated.

    indexInListinteger<int32>

    The index of this address in the list of addresses.

    latitudenumber

    The GPS latitude of this address in signed degrees format (DDD.dddd) with 6 decimal positions, ranging from -90 to +90.

    line1string

    The first line of the address.

    line2string

    The second line of the address.

    longitudenumber

    The GPS longitude of this address in signed degrees format (DDD.dddd) with 6 decimal positions, ranging from -180 to +180.

    parentKeystring

    The address parent key indicating the object owning this address. For example: client, centre, or branch.

    postcodestring

    The post code.

    regionstring

    The region for the address.

  • ]
  • approvedDatestring<date-time>

    The date when a client was approved.

    Example: 2016-09-06T13:37:50+03:00
    assignedBranchKeystring

    The encoded key of the branch a client is assigned to.

    assignedCentreKeystring

    The encoded key of the centre a client is assigned to.

    assignedUserKeystring

    The encoded key of the user a client is assigned to.

    birthDatestring<date>

    The client's date of birth.

    Example: 1987-04-26
    clientRoleKeystring

    A role which describes the intended use of a client in the system.

    closedDatestring<date-time>

    The date when the client state was changed to closed.

    Example: 2016-09-06T13:37:50+03:00
    creationDatestring<date-time>

    The date a client was created.

    Example: 2016-09-06T13:37:50+03:00
    emailAddressstring

    The client's email address.

    encodedKeystring

    The encoded key of the client, which is unique and generated.

    firstNamestringrequired

    The first name, personal name, given name, or forename of the client.

    genderstring

    The client's gender, the options are male or female.

    Possible values: [MALE, FEMALE]

    groupKeysstring[]

    The groups to which this client belongs.

    groupLoanCycleinteger<int32>

    Number of paid and closed (with 'obligations met') accounts for a client's group; when the closing operation is reverted, this is reduced.

    homePhonestring

    The client's home phone number.

    idstring

    The ID of the client, which can be generated and customized - but must be unique.

    idDocuments object[]

    The identification documents for this client.

  • Array [
  • attachments object[]

    A list containing information about the attached files for this document

  • Array [
  • creationDatestring<date-time>

    The creation date of the document, stored as UTC

    Example: 2016-09-06T13:37:50+03:00
    encodedKeystring

    The document encodedKey

    fileNamestring

    The original file name of the document

    fileSizeinteger<int64>

    The file size of the document

    idinteger<int64>required

    The document id

    lastModifiedDatestring<date-time>

    The last modified date of the document, stored as UTC

    Example: 2016-09-06T13:37:50+03:00
    locationstring

    Location where the document can be found, eg /myfiles/mypicture.jpeg

    namestringrequired

    The name of the document

    notesstring

    Detailed notes about the document

    ownerKeystring

    Represents the holder of this document. If null, means nobody is the owner of this document

    ownerTypestring

    Determines the owner type of the document

    Possible values: [CLIENT, GROUP, LOAN_PRODUCT, SAVINGS_PRODUCT, CENTRE, BRANCH, USER, LOAN_ACCOUNT, DEPOSIT_ACCOUNT, ID_DOCUMENT, LINE_OF_CREDIT, GL_JOURNAL_ENTRY]

    typestringrequired

    The extension of the document

  • ]
  • clientKeystring

    The encoded key of the client that owns this document

    documentIdstringrequired

    The id of the document

    documentTypestringrequired

    The type of the document, Passport, Id card Drivers license, etc.

    encodedKeystring

    The encoded key of the document, generated, unique

    identificationDocumentTemplateKeystring

    Encoded key of the template used for this document

    indexInListinteger<int32>

    This document's index in the list of documents

    issuingAuthoritystring

    Authority that issued the document, eg. Police

    validUntilstring<date>

    Date when the validity of the document ends

    Example: 1987-04-26
  • ]
  • lastModifiedDatestring<date-time>

    The last date a client was modified.

    Example: 2016-09-06T13:37:50+03:00
    lastNamestringrequired

    The last name, surname, or family name of the client.

    loanCycleinteger<int32>

    Number of paid and closed (with 'obligations met') accounts for a client; when the closing operation is reverted, this is reduced.

    middleNamestring

    The middle name of the client.

    migrationEventKeystring

    The migration event encoded key associated with a client.

    mobilePhonestring

    The client's mobile phone number.

    mobilePhone2string

    The client's second mobile phone number.

    notesstring

    The additional notes about a client.

    portalSettings object

    Represents portal settings for an individual client.

    encodedKeystring

    The encoded key of the entity, generated, globally unique

    lastLoggedInDatestring<date-time>

    The last date the client logged in to the portal.

    Example: 2016-09-06T13:37:50+03:00
    portalStatestring

    The state of the client portal for a client

    Possible values: [ENABLED, DISABLED]

    preferredLanguagestring

    The client's preferred language. This will determine the language for the reports, schedules, and account statements you generate for the client.

    Possible values: [ENGLISH, PORTUGESE, SPANISH, RUSSIAN, FRENCH, GEORGIAN, CHINESE, INDONESIAN, ROMANIAN, BURMESE, GERMAN, PORTUGUESE_BRAZIL, VIETNAMESE, ITALIAN, THAI, NORWEGIAN, PHRASE]

    profilePictureKeystring

    The encoded key of a client's profile picture.

    profileSignatureKeystring

    The encoded key of the client's profile signature.

    statestring

    The state of a client. It shows where the client is in the client life cycle.

    Possible values: [PENDING_APPROVAL, INACTIVE, ACTIVE, EXITED, BLACKLISTED, REJECTED]

    Client
    {
    "activationDate": "2016-09-06T13:37:50+03:00",
    "addresses": [
    {
    "city": "string",
    "country": "string",
    "encodedKey": "string",
    "indexInList": 0,
    "latitude": 0,
    "line1": "string",
    "line2": "string",
    "longitude": 0,
    "parentKey": "string",
    "postcode": "string",
    "region": "string"
    }
    ],
    "approvedDate": "2016-09-06T13:37:50+03:00",
    "assignedBranchKey": "string",
    "assignedCentreKey": "string",
    "assignedUserKey": "string",
    "birthDate": "1987-04-26",
    "clientRoleKey": "string",
    "closedDate": "2016-09-06T13:37:50+03:00",
    "creationDate": "2016-09-06T13:37:50+03:00",
    "emailAddress": "string",
    "encodedKey": "string",
    "firstName": "string",
    "gender": "MALE",
    "groupKeys": [
    "string"
    ],
    "groupLoanCycle": 0,
    "homePhone": "string",
    "id": "string",
    "idDocuments": [
    {
    "attachments": [
    {
    "creationDate": "2016-09-06T13:37:50+03:00",
    "encodedKey": "string",
    "fileName": "string",
    "fileSize": 0,
    "id": 0,
    "lastModifiedDate": "2016-09-06T13:37:50+03:00",
    "location": "string",
    "name": "string",
    "notes": "string",
    "ownerKey": "string",
    "ownerType": "CLIENT",
    "type": "string"
    }
    ],
    "clientKey": "string",
    "documentId": "string",
    "documentType": "string",
    "encodedKey": "string",
    "identificationDocumentTemplateKey": "string",
    "indexInList": 0,
    "issuingAuthority": "string",
    "validUntil": "1987-04-26"
    }
    ],
    "lastModifiedDate": "2016-09-06T13:37:50+03:00",
    "lastName": "string",
    "loanCycle": 0,
    "middleName": "string",
    "migrationEventKey": "string",
    "mobilePhone": "string",
    "mobilePhone2": "string",
    "notes": "string",
    "portalSettings": {
    "encodedKey": "string",
    "lastLoggedInDate": "2016-09-06T13:37:50+03:00",
    "portalState": "ENABLED"
    },
    "preferredLanguage": "ENGLISH",
    "profilePictureKey": "string",
    "profileSignatureKey": "string",
    "state": "PENDING_APPROVAL"
    }