POST api/clientsSearch?maxResults={maxResults}
Searches for clients that exactly match search criteria.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| maxResults |
The maximum number of results to return. Returning many results may greatly slow down execution. If this is null, there is no limit. |
integer |
None. |
Body Parameters
The information to use to look up the client.
GetClientSecureRequest| Name | Description | Type | Additional information |
|---|---|---|---|
| ClientId |
The ID of the client. |
integer |
None. |
| ClientCode |
The client code. |
string |
None. |
| AlternateId |
Alternate ID of the client (meaning changes depending on the system). |
string |
None. |
| DateOfBirth |
The client's birth date. |
date |
None. |
| FirstName |
The client's first name. |
string |
None. |
| LastName |
The client's last name. |
string |
None. |
| EmailAddress |
The client's preferred email address. |
string |
None. |
| PhoneNumber |
The client's phone number |
string |
None. |
| ServiceTypeId |
The client's default service type |
integer |
None. |
| FilterInactiveClients |
True if we want to filter out inactive clients, false otherwise |
boolean |
None. |
Request Formats
application/json, text/json
Sample:
{
"clientId": 1,
"clientCode": "sample string 1",
"alternateId": "sample string 2",
"dateOfBirth": "2025-12-10",
"firstName": "sample string 3",
"lastName": "sample string 4",
"emailAddress": "sample string 5",
"phoneNumber": "sample string 6",
"serviceTypeId": 1,
"filterInactiveClients": true
}
application/xml, text/xml
Sample:
<GetClientSecureRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TS.DR.Resources"> <AlternateId>sample string 2</AlternateId> <ClientCode>sample string 1</ClientCode> <ClientId>1</ClientId> <DateOfBirth>2025-12-10T06:31:52.8302571-07:00</DateOfBirth> <EmailAddress>sample string 5</EmailAddress> <FilterInactiveClients>true</FilterInactiveClients> <FirstName>sample string 3</FirstName> <LastName>sample string 4</LastName> <PhoneNumber>sample string 6</PhoneNumber> <ServiceTypeId>1</ServiceTypeId> </GetClientSecureRequest>
application/x-www-form-urlencoded
Sample:
Sample not available.
Response Information
Resource Description
Collection of Client| Name | Description | Type | Additional information |
|---|---|---|---|
| Href |
Url for accessing this client object over web. |
string |
None. |
| Id |
Gets or sets the client's internal ID in the paratransit application's database. |
integer |
None. |
| ClientCode |
Gets or sets the passenger's Client Code in the paratransit application's database. This should only be used as an alternate login ID. |
string |
None. |
| FirstName |
Gets or sets the client's first name. |
string |
None. |
| MiddleName |
Gets or sets the client's middle name. |
string |
None. |
| LastName |
Gets or sets the client's last name. |
string |
None. |
| BirthDate |
Gets or sets the client's date of birth. |
date |
None. |
| Title |
Gets or sets client's title. |
string |
None. |
| Gender |
Gets or sets whether the client is male or female (or unknown). |
Gender |
None. |
| GenderString |
Gets or sets the client's gender. |
string |
None. |
| IdentificationNumber |
Gets or sets the client's identification number. |
string |
None. |
| SpaceTypeCode |
Gets or sets the code of the client's default space type. |
string |
None. |
| MobilityAidCodes |
Gets or sets the client's default list of mobility aids. |
Collection of string |
None. |
| AdditionalPassenger |
Gets or sets the client's default additional passenger, if any. |
ClientDefaultPassenger |
None. |
| Addresses |
Gets or sets a list of the client's registered addresses. |
Collection of RegisteredAddress |
None. |
| IsActive |
Gets or sets whether the client is currently active. |
boolean |
None. |
| Statuses |
Gets or sets the client's details about the client's historical eligibility status. |
Collection of ClientStatus |
None. |
| FundingPrograms |
Gets or sets the list of funding sources that can help pay for the client's trips. |
Collection of ClientFundingProgram |
None. |
| Services |
Gets or sets specific service type configuration for this client. |
Collection of ClientService |
None. |
| PreferredLanguage |
Gets or sets the client's preferred language code. May be null if not set. |
string |
None. |
| Notifications |
Gets or sets the list of notifications that this client would like to receive. Only applicable if IVR is enabled. |
Collection of NotificationType |
None. |
| PrivateComments |
Gets or sets the client's private comments. |
string |
None. |
| SchedulingComments |
Gets or sets the client's scheduling comments. |
string |
None. |
| BookingComments |
Gets or sets the client's booking comments. |
string |
None. |
| UserDefinedFields |
Gets or sets the list of user-defined field values. |
Dictionary of string [key] and Object [value] |
None. |
| Attachments |
Gets or sets the list of attachments in client profile |
Collection of Attachment |
None. |
| Agencies |
Gets or sets agencies client is associated to |
Collection of ClientOrgUnit |
None. |
| PreferredProvider |
Gets or sets preferred provider for the client |
Provider |
None. |
| PrepaidPaymentOption |
Gets or sets client's prepayment options value |
PrepaidPaymentOption |
None. |
| Contacts |
Gets or sets the list of client's contacts. |
Collection of Contact |
None. |
| IVRCallbackClient |
Gets or sets whether the client should be notified about trips |
boolean |
None. |
| WebDisabled |
Gets or sets whether the client has the web disabled setting enabled |
boolean |
None. |
| TicketBalance |
Gets or sets the client's ticket balance |
Collection of Ticket |
None. |
Response Formats
application/json, text/json
Sample:
[
{
"href": "sample string 1",
"id": 2,
"clientCode": "sample string 3",
"firstName": "sample string 4",
"middleName": "sample string 5",
"lastName": "sample string 6",
"birthDate": "2025-12-10",
"title": "sample string 7",
"gender": 0,
"genderString": "sample string 8",
"identificationNumber": "sample string 9",
"spaceTypeCode": "sample string 10",
"mobilityAidCodes": [
"sample string 1",
"sample string 2"
],
"additionalPassenger": {
"passengerTypeCode": "sample string 1",
"spaceTypeCode": "sample string 2",
"required": true,
"isNotAllowedEscorts": true,
"fundingProgramIds": [
1,
2
]
},
"addresses": [
{
"addressTypeCode": "sample string 1",
"dates": null,
"locationID": 1,
"id": 1,
"description": "sample string 2",
"category": "sample string 3",
"categoryId": "sample string 4",
"name": "sample string 5",
"latitude": 1.1,
"longitude": 1.1,
"streetNumber": "sample string 6",
"onStreet": "sample string 7",
"atStreet": "sample string 8",
"city": "sample string 9",
"state": "sample string 10",
"postalCode": "sample string 11",
"itemType": 0,
"internalType": 0,
"unit": "sample string 12",
"comments": "sample string 13",
"isGeocoded": true,
"contact": {
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
},
"country": "sample string 15",
"stopCode": "sample string 16",
"procedureModifier": "sample string 17",
"timeZoneId": "sample string 18"
},
{
"addressTypeCode": "sample string 1",
"dates": null,
"locationID": 1,
"id": 1,
"description": "sample string 2",
"category": "sample string 3",
"categoryId": "sample string 4",
"name": "sample string 5",
"latitude": 1.1,
"longitude": 1.1,
"streetNumber": "sample string 6",
"onStreet": "sample string 7",
"atStreet": "sample string 8",
"city": "sample string 9",
"state": "sample string 10",
"postalCode": "sample string 11",
"itemType": 0,
"internalType": 0,
"unit": "sample string 12",
"comments": "sample string 13",
"isGeocoded": true,
"contact": {
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
},
"country": "sample string 15",
"stopCode": "sample string 16",
"procedureModifier": "sample string 17",
"timeZoneId": "sample string 18"
}
],
"isActive": true,
"statuses": [
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00",
"isActive": true,
"status": "sample string 3",
"comments": "sample string 4"
},
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00",
"isActive": true,
"status": "sample string 3",
"comments": "sample string 4"
}
],
"fundingPrograms": [
{
"sequence": 1,
"isDefault": true,
"isDedicated": true,
"isPrepaid": true,
"id": 4,
"name": "sample string 5",
"fundingSourceId": 6,
"description": "sample string 7",
"validDates": [
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
},
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
}
]
},
{
"sequence": 1,
"isDefault": true,
"isDedicated": true,
"isPrepaid": true,
"id": 4,
"name": "sample string 5",
"fundingSourceId": 6,
"description": "sample string 7",
"validDates": [
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
},
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
}
]
}
],
"services": [
{
"serviceTypeId": 1,
"validDates": [
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
},
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
}
],
"isDefault": true
},
{
"serviceTypeId": 1,
"validDates": [
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
},
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
}
],
"isDefault": true
}
],
"preferredLanguage": "sample string 12",
"notifications": [
{
"typeCode": "sample string 1",
"typeName": "sample string 2",
"method": 0,
"enabled": true
},
{
"typeCode": "sample string 1",
"typeName": "sample string 2",
"method": 0,
"enabled": true
}
],
"privateComments": "sample string 13",
"schedulingComments": "sample string 14",
"bookingComments": "sample string 15",
"userDefinedFields": {
"sample string 1": {},
"sample string 3": {}
},
"attachments": [
{
"fileId": 1,
"name": "sample string 2",
"fileType": "sample string 3",
"fileSize": 1,
"fileData": "sample string 4",
"description": "sample string 5",
"fileMark": 0
},
{
"fileId": 1,
"name": "sample string 2",
"fileType": "sample string 3",
"fileSize": 1,
"fileData": "sample string 4",
"description": "sample string 5",
"fileMark": 0
}
],
"agencies": [
{
"clientId": 1,
"organizationId": 2
},
{
"clientId": 1,
"organizationId": 2
}
],
"preferredProvider": {
"id": 1,
"name": "sample string 2",
"description": "sample string 3",
"activeDates": [
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
},
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
}
]
},
"prepaidPaymentOption": 1,
"contacts": [
{
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
},
{
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
}
],
"ivrCallbackClient": true,
"webDisabled": true,
"ticketBalance": [
{
"paymentTypeId": "sample string 1",
"quantity": 2,
"description": "sample string 3"
},
{
"paymentTypeId": "sample string 1",
"quantity": 2,
"description": "sample string 3"
}
]
},
{
"href": "sample string 1",
"id": 2,
"clientCode": "sample string 3",
"firstName": "sample string 4",
"middleName": "sample string 5",
"lastName": "sample string 6",
"birthDate": "2025-12-10",
"title": "sample string 7",
"gender": 0,
"genderString": "sample string 8",
"identificationNumber": "sample string 9",
"spaceTypeCode": "sample string 10",
"mobilityAidCodes": [
"sample string 1",
"sample string 2"
],
"additionalPassenger": {
"passengerTypeCode": "sample string 1",
"spaceTypeCode": "sample string 2",
"required": true,
"isNotAllowedEscorts": true,
"fundingProgramIds": [
1,
2
]
},
"addresses": [
{
"addressTypeCode": "sample string 1",
"dates": null,
"locationID": 1,
"id": 1,
"description": "sample string 2",
"category": "sample string 3",
"categoryId": "sample string 4",
"name": "sample string 5",
"latitude": 1.1,
"longitude": 1.1,
"streetNumber": "sample string 6",
"onStreet": "sample string 7",
"atStreet": "sample string 8",
"city": "sample string 9",
"state": "sample string 10",
"postalCode": "sample string 11",
"itemType": 0,
"internalType": 0,
"unit": "sample string 12",
"comments": "sample string 13",
"isGeocoded": true,
"contact": {
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
},
"country": "sample string 15",
"stopCode": "sample string 16",
"procedureModifier": "sample string 17",
"timeZoneId": "sample string 18"
},
{
"addressTypeCode": "sample string 1",
"dates": null,
"locationID": 1,
"id": 1,
"description": "sample string 2",
"category": "sample string 3",
"categoryId": "sample string 4",
"name": "sample string 5",
"latitude": 1.1,
"longitude": 1.1,
"streetNumber": "sample string 6",
"onStreet": "sample string 7",
"atStreet": "sample string 8",
"city": "sample string 9",
"state": "sample string 10",
"postalCode": "sample string 11",
"itemType": 0,
"internalType": 0,
"unit": "sample string 12",
"comments": "sample string 13",
"isGeocoded": true,
"contact": {
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
},
"country": "sample string 15",
"stopCode": "sample string 16",
"procedureModifier": "sample string 17",
"timeZoneId": "sample string 18"
}
],
"isActive": true,
"statuses": [
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00",
"isActive": true,
"status": "sample string 3",
"comments": "sample string 4"
},
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00",
"isActive": true,
"status": "sample string 3",
"comments": "sample string 4"
}
],
"fundingPrograms": [
{
"sequence": 1,
"isDefault": true,
"isDedicated": true,
"isPrepaid": true,
"id": 4,
"name": "sample string 5",
"fundingSourceId": 6,
"description": "sample string 7",
"validDates": [
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
},
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
}
]
},
{
"sequence": 1,
"isDefault": true,
"isDedicated": true,
"isPrepaid": true,
"id": 4,
"name": "sample string 5",
"fundingSourceId": 6,
"description": "sample string 7",
"validDates": [
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
},
{
"fromDate": "2025-12-10T06:31:52.8372541-07:00",
"toDate": "2025-12-10T06:31:52.8372541-07:00"
}
]
}
],
"services": [
{
"serviceTypeId": 1,
"validDates": [
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
},
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
}
],
"isDefault": true
},
{
"serviceTypeId": 1,
"validDates": [
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
},
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
}
],
"isDefault": true
}
],
"preferredLanguage": "sample string 12",
"notifications": [
{
"typeCode": "sample string 1",
"typeName": "sample string 2",
"method": 0,
"enabled": true
},
{
"typeCode": "sample string 1",
"typeName": "sample string 2",
"method": 0,
"enabled": true
}
],
"privateComments": "sample string 13",
"schedulingComments": "sample string 14",
"bookingComments": "sample string 15",
"userDefinedFields": {
"sample string 1": {},
"sample string 3": {}
},
"attachments": [
{
"fileId": 1,
"name": "sample string 2",
"fileType": "sample string 3",
"fileSize": 1,
"fileData": "sample string 4",
"description": "sample string 5",
"fileMark": 0
},
{
"fileId": 1,
"name": "sample string 2",
"fileType": "sample string 3",
"fileSize": 1,
"fileData": "sample string 4",
"description": "sample string 5",
"fileMark": 0
}
],
"agencies": [
{
"clientId": 1,
"organizationId": 2
},
{
"clientId": 1,
"organizationId": 2
}
],
"preferredProvider": {
"id": 1,
"name": "sample string 2",
"description": "sample string 3",
"activeDates": [
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
},
{
"fromDate": "2025-12-10",
"toDate": "2025-12-10"
}
]
},
"prepaidPaymentOption": 1,
"contacts": [
{
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
},
{
"id": 1,
"referenceId": "sample string 2",
"contactType": "sample string 3",
"firstName": "sample string 4",
"lastName": "sample string 5",
"comments": "sample string 6",
"details": [
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
},
{
"id": 1,
"contactString": "sample string 2",
"type": {
"code": "sample string 1",
"name": "sample string 2",
"type": 0
},
"isPreferred": true
}
]
}
],
"ivrCallbackClient": true,
"webDisabled": true,
"ticketBalance": [
{
"paymentTypeId": "sample string 1",
"quantity": 2,
"description": "sample string 3"
},
{
"paymentTypeId": "sample string 1",
"quantity": 2,
"description": "sample string 3"
}
]
}
]
application/xml
Sample:
Sample not available.
text/xml
Sample:
Sample not available.