GET Clients/Client

Get clients

Request Information

URI Parameters

NameDescriptionTypeAdditional information
IncludeActive

Include records where RecordState == RecordState.Active

boolean

None.

IncludeInactive

Include records where RecordState == RecordState.Inactive

boolean

None.

IncludeDeleted

Include records where RecordState == RecordState.Deleted

boolean

None.

ExcludeDischargedDeceased

Exclude records where BU is Discharged/Deceased

boolean

None.

ExcludeDischarged

Exclude records where BU is Discharged

boolean

None.

ExcludeDeceased

Exclude records where BU is Deceased

boolean

None.

ResidentNumberFieldName

Include extension Resident Number

string

None.

Match

When searching by string, include records based on match type

MatchCriteriaStringType

None.

ClientIDs

Filter by ClientIDs

Collection of integer

None.

Area

Filter by Area

string

None.

Gender

Filter by Gender

string

None.

MaritalStatus

Filter by MaritalStatus

string

None.

JobTitle

Filter by JobTitle

string

None.

Comments

Filter by Comments

string

None.

BirthDateMin

Filter by BirthDateMin

date

None.

BirthDateMax

Filter by BirthDateMax

date

None.

DeceasedDateMin

Filter by DeceasedDateMin

date

None.

DeceasedDateMax

Filter by DeceasedDateMax

date

None.

Name

Filter by Name

NameDTO

None.

MatchingFirstOrLastName

Name to match with first or last name.

string

None.

CreatedDateUtcMin

Filter by CreatedDateUtcMin

date

None.

CreatedDateUtcMax

Filter by CreatedDateUtcMax

date

None.

BUCreatedDateUtcMin

Filter by Business Unit's CreatedDateUtcMin

date

None.

BUCreatedDateUtcMax

Filter by Business Unit's CreatedDateUtcMax

date

None.

LastUpdatedDateUtcMin

Filter by LastUpdatedDateUtcMin

date

None.

LastUpdatedDateUtcMax

Filter by LastUpdatedDateUtcMax

date

None.

BULastUpdatedDateUtcMin

Filter by Business Unit's LastUpdatedDateUtcMin

date

None.

BULastUpdatedDateUtcMax

Filter by Business Unit's LastUpdatedDateUtcMax

date

None.

BusinessUnits

Filter by BusinessUnit(s)

Collection of integer

None.

BusinessUnitStatuses

Filter by BusinessUnitStatuses

Collection of integer

None.

Funders

Filter by Funder(s)

Collection of integer

None.

BusinessUnitStatusTypes

Filter by BusinessUnitStatuses Types

Collection of BusinessUnitStatusPropStatusType

None.

Groups

Filter by Group(s)

Collection of integer

None.

BedGroups

Filter by Bed Group(s)

Collection of integer

None.

GroupStatuses

Filter by GroupStatuses

Collection of integer

None.

GroupStatusTypes

Filter by GroupStatuses Types

Collection of BusinessUnitStatusPropStatusType

None.

Fields

Filter by Fields

Collection of FindExtensionCriteria

None.

PartialDataType

Only return partial data to speed up call (results cannot be used for add/update)

PartialDataType

None.

IncludeBinaries

Include binaries

boolean

None.

CaseloadCriteria

Include caseload criteria (null means don't filter by caseload criteria)

FindClientCaseloadCriteria

None.

EntityUserChangeLastUpdatedDateUtcMin

Filter by EntityUserChangeLastUpdatedOnMin

date

None.

EntityUserChangeCodes

Filter by EntityUserChangeCodes

Collection of string

None.

Sort

Sort Critiera for searches

Collection of FindSortByCriteria

None.

MaxRows

Limit number of rows

integer

None.

Body Parameters

None.

Response Information

Resource Description

List of ClientDTOs

Collection of ClientDTO
NameDescriptionTypeAdditional information
ClientID

The unique identifier for the Client record.

integer

None.

ExternalClientID

External ID for the client.

string

None.

Area

The area where the client resides.

string

None.

Gender

Gender. Input from code table entries where TableName is "Genders", ().

string

None.

MaritalStatus

Marital Status. Input from code table entries where TableName is "Marital Statuses", ().

string

None.

JobTitle

The job title of the client.

string

None.

Comments

Comments (if any).

string

None.

Props

A collection of additional properties for the User, .

Collection of Object

None.

BirthDate

The birth date of the client.

date

None.

Age

The age of the client. This field is read-only and is calculated from the birth date.

integer

None.

BirthMonth

The birth month of the client. This field is read-only and is derived from the birth date.

byte

None.

BirthDay

The birth day of the client. This field is read-only and is derived from the birth date.

byte

None.

DeceasedDate

The date of death of the client.

date

None.

TZIDEntryID

The Timezone (TZID) for the Client record. Input from code table entries where TableName is "Timezones (TZID)", ().

integer

None.

WindowsTZEntryID

The Windows Timezone for the Client record.

integer

None.

RecordState

The state of the record, .

RecordState

None.

BirthCountryCode

The country code of the client's birth country.

string

None.

IsBirthDateEstimated

Indicates if the birth date is estimated.

boolean

None.

Religion

The religion of the client.

string

None.

Ethnicity

The ethnicity of the client.

string

None.

Name

The full name of the client, .

NameDTO

None.

Addresses

The addresses of the client, .

AddressesDTO

None.

BusinessUnits

The list of business units associated with the client, ."/>

Collection of ClientBusinessUnitDTO

None.

Groups

The list of groups attached to the client, .

Collection of ClientGroupDTO

None.

CurrentFacility

The name of the client's current group. This field is read-only and is derived from the client's current group.

string

None.

CurrentGroup

The client's current group. This field is read-only and is derived from the client's groups, .

ClientGroupDTO

None.

CurrentLocation

This field is read-only and is automatically set from the client's current group. If there's no current group, the primary address is returned.

string

None.

CurrentStatusReason

The reason for the client's current status.

string

None.

CurrentStatusName

The name of the client's current status.

string

None.

CurrentStatusStartDateUtc

The start date of the client's current status in UTC.

date

None.

IsResident

Indicates if the client is a resident.

boolean

None.

ImageExists

Indicates if an image exists for the client. This field is read-only.

boolean

None.

ImageEntityFileID

The ID of the image entity file.

integer

None.

ImageEntityFileKey

The key of the image entity file.

string

None.

ImageEntityFileDateUtc

The date of the image entity file in UTC.

date

None.

ImageEntityFileLastUpdatedDateUtc

The last updated date of the image entity file in UTC.

date

None.

Notifications

The list of notifications attached to the client, .

Collection of ClientNotificationDTO

None.

CommunicationMethods

The communication methods of the client, .

CommunicationMethodsDTO

None.

Extensions

The list of extensions attached to the client, .

Collection of FormDataExtensionDto

None.

PartialData

Indicates if only partial data should be returned to speed up the call.

PartialDataType

None.

Created

The audit information for the creation of the record, including the creation date in UTC and the user who created it, . This field is readonly.

AuditDataDTO

None.

LastUpdated

The audit information for the last update to the record, including the update date in UTC and the user who made the update, . This field is readonly.

AuditDataDTO

None.

Summary

The summary of the client's name. This field is read-only.

string

None.

Funders

The list of funders for the client, .

Collection of FunderDTO

None.

Scores

The scores of the client, .

ClientScoresDTO

None.

AccommodationsDefaultPaymentMethod

The default payment method for accommodation, .

PaymentMethod

None.

FeesDefaultPaymentMethod

The default payment method for fees, .

PaymentMethod

None.