GET api/contacts?studentId={studentId}&salutationId={salutationId}&name={name}&nameContains={nameContains}&surname={surname}&surnameContains={surnameContains}&gender={gender}&dateOfBirth={dateOfBirth}&emailAddress={emailAddress}&countryOfResidenceId={countryOfResidenceId}&countryOfCitizenshipId={countryOfCitizenshipId}&countryOfBirthId={countryOfBirthId}&dateCreatedFrom={dateCreatedFrom}&dateCreatedTo={dateCreatedTo}&inactive={inactive}&offset={offset}&limit={limit}&returnTotal={returnTotal}

Get all Contacts optionally filtered by any of the arguments specified in the query string.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
studentId

Optional case-insensitive filter on Contacts with a studentId in the given institution that matches the provided value.

string

None.

salutationId

Optional filter on Contacts with a SalutationId that matches the provided value.

integer

None.

name

Optional case-insensitive filter on Contacts with a given name that matches the provided value.

string

None.

nameContains

Optional case-insensitive filter on Contacts with a given name containing the provided value.

string

None.

surname

Optional case-insensitive filter on Contacts with a surname that matches the provided value.

string

None.

surnameContains

Optional case-insensitive filter on Contacts with a surname containing the provided value.

string

None.

gender

Optional case-insensitive filter on Contacts with a gender that matches the provided value.

character

None.

dateOfBirth

Optional filter on Contacts with a birth date that matches the provided value.

date

None.

emailAddress

Optional case-insensitive filter on Contacts with a primary email address that matches the provided value.

string

None.

countryOfResidenceId

Optional filter on Contacts with a CountryOfResidenceId that matches the provided value.

integer

None.

countryOfCitizenshipId

Optional filter on Contacts with a CountryOfCitizenshipId that matches the provided value.

integer

None.

countryOfBirthId

Optional filter on Contacts with a CountryOfBirthId that matches the provided value.

integer

None.

dateCreatedFrom

Optional filter on Contacts that were created on a date from the provided value.

date

None.

dateCreatedTo

Optional filter on Contacts that were created on a date up to (inclusive) the provided value.

date

None.

inactive

Filter indicating whether to retrieve active or inactive records.

boolean

Default value is False

offset

The position in the collection of Contacts from which to start returning data from.

integer

Default value is 0

limit

The maximum amount of Contacts that can be returned in any one call. Maximum allowed is 20.

integer

Default value is 10

returnTotal

Whether to include the total amount of Contacts in the database that match the filter specified.

boolean

Default value is False

Body Parameters

None.

Response Information

Resource Description

ContactDto
NameDescriptionTypeAdditional information
Id

The primary key of the record in the Hobsons database. Ignored for PUT (except bulk updates) and POST requests sent to the API.

integer

None.

StudentId

The unique identifier for the contact in the institution.

string

String length: inclusive between 0 and 30

SalutationId

A reference to the primary key of the Salutation record that is binded to the contact.

integer

Range: inclusive between 1 and 99999999

SalutationName

The name of the Salutation record that is binded to the contact. Ignored for PUT and POST requests sent to the API.

string

None.

Name

The given name of the contact.

string

String length: inclusive between 0 and 120

Surname

The family name of the contact.

string

String length: inclusive between 0 and 120

MiddleName

Any additional names that are given to the contact.

string

String length: inclusive between 0 and 100

Alias

Any aliases that the contact may also be known by.

string

String length: inclusive between 0 and 120

FormerName

Any names that the contact previously held.

string

String length: inclusive between 0 and 120

Gender

The gender of the Contact. Valid values are 'M', 'F', 'X' and 'N', which denote Male, Female, Gender Neutral and Not Disclosed respectively.

character

None.

DateOfBirth

The date of birth of the Contact. Note that only the date component it's used, the time component will be ignored if specified.

date

Range: inclusive between 1 Jan 1900 and 31 Dec 2099

EmailAddress

The primary email address that is used to communicate with the contact.

string

String length: inclusive between 0 and 254

IsPermanentResident

Whether the student has a permanent resident visa in the country that the institution is in.

boolean

Required

CountryOfResidenceId

A reference to the primary key of the Country record that is binded as the contact's country of residence.

integer

Range: inclusive between 1 and 99999999

CountryOfResidenceName

The name of the Country record that is binded as the contact's country of residence. Ignored for PUT and POST requests sent to the API.

string

None.

CountryOfCitizenshipId

A reference to the primary key of the Country record that is binded as the contact's country of citizenship.

integer

Range: inclusive between 1 and 99999999

CountryOfCitizenshipName

The name of the Country record that is binded as the contact's country of citizenship. Ignored for PUT and POST requests sent to the API.

string

None.

CountryOfBirthId

A reference to the primary key of the Country record that is binded as the contact's country of birth.

integer

Range: inclusive between 1 and 99999999

CountryOfBirthName

The name of the Country record that is binded as the contact's country of birth. Ignored for PUT and POST requests sent to the API.

string

None.

DateCreated

The date that the Contact record was created (in the Hobsons database). Ignored for PUT and POST requests sent to the API.

date

None.

DateModified

The date that the Contact record was last modified (in the Hobsons database). Ignored for PUT and POST requests sent to the API.

date

None.

HeatStatusId

A reference to the primary key of the HeatStatus record that is binded as the contact's current HeatStatus.

integer

Required

Range: inclusive between 1 and 99999999

HeatStatusName

The name of the HeatStatus record that is binded as the contacts current HeatStatus. Ignored for PUT and POST requests sent to the API.

string

None.

HeatStatusChangeReason

The reason why the Contact's HeatStatusId value is changing (or created). The provided value will be stored as part of a new ContactHeatStatus record. Required for PUT requests sent to the API. For POST requests if a reason is not provided, Hobsons will set a default reason. Used ONLY for PUT and POST requests sent to the API. For GET requests always returned as NULL.

string

String length: inclusive between 0 and 100

SubChannelId

A reference to the primary key of the SubChannel record that is associated with this record. For POST or PUT requests sent to the API where this value is changing, the SubChannel record must belong to the parent Channel named 'External'.

integer

Required

Range: inclusive between 1 and 99999999

SubChannelName

The name of the SubChannel record that is associated with this record. Ignored for PUT and POST requests sent to the API.

string

None.

ChannelId

A reference to the primary key of the Channel record that is the parent of the SubChannel record. Ignored for PUT and POST requests sent to the API.

integer

None.

ChannelName

The name of the Channel record that is the parent of the SubChannel record. Ignored for PUT and POST requests sent to the API.

string

None.

ContactStatusId

A reference to the primary key of the ContactStatus record that is currently associated with this record.

integer

Required

Range: inclusive between 1 and 99999999

ContactStatusName

The name of the ContactStatus record that is currently associated with this record. Ignored for PUT and POST requests sent to the API.

string

None.

ContactStatusChangeReason

The reason why the Contact's ContactStatusId value is changing (or created). The provided value will be stored as part of a new ContactContactStatus record. Required for PUT requests sent to the API. For POST requests if a reason is not provided, Hobsons will set a default reason. Used ONLY for PUT and POST requests sent to the API. For GET requests always returned as NULL.

string

String length: inclusive between 0 and 100

IntakeId

A reference to the primary key of the Intake record that is currently associated with this record. Ignored for PUT and POST requests sent to the API.

integer

None.

IntakeName

The name of the Intake record that is currently associated with this record. Ignored for PUT and POST requests sent to the API.

string

None.

Inactive

boolean

Required

Response Formats

application/json, text/json

Sample:
{
  "Id": 1,
  "StudentId": "sample string 2",
  "SalutationId": 1,
  "SalutationName": "sample string 3",
  "Name": "sample string 4",
  "Surname": "sample string 5",
  "MiddleName": "sample string 6",
  "Alias": "sample string 7",
  "FormerName": "sample string 8",
  "Gender": "A",
  "DateOfBirth": "2024-05-08T19:24:25.3102892+10:00",
  "EmailAddress": "sample string 9",
  "IsPermanentResident": true,
  "CountryOfResidenceId": 1,
  "CountryOfResidenceName": "sample string 11",
  "CountryOfCitizenshipId": 1,
  "CountryOfCitizenshipName": "sample string 12",
  "CountryOfBirthId": 1,
  "CountryOfBirthName": "sample string 13",
  "DateCreated": "2024-05-08T19:24:25.3102892+10:00",
  "DateModified": "2024-05-08T19:24:25.3102892+10:00",
  "HeatStatusId": 1,
  "HeatStatusName": "sample string 14",
  "HeatStatusChangeReason": "sample string 15",
  "SubChannelId": 1,
  "SubChannelName": "sample string 16",
  "ChannelId": 1,
  "ChannelName": "sample string 17",
  "ContactStatusId": 1,
  "ContactStatusName": "sample string 18",
  "ContactStatusChangeReason": "sample string 19",
  "IntakeId": 1,
  "IntakeName": "sample string 20",
  "Inactive": true
}