A person who uses the services of the care provider, this might be a resident at a residential/nursing home or a client of a home care or live-in care service.
A unique Id for the service user.
The service user's account code (used when exporting invoices to an accounts package).
The date/time the service user was anonymized (if anonymized).
Flag indicating that the service user requires assistance with dressing.
Flag indicating that the service user requires assistance with with eating.
Flag indicating that the service user requires assistance with taking medication.
Flag indicating that the service user requires assistance with personal care.
Flag indicating that invoices for expenses should be billed to the service user themselves.
The billing party's preference for receiving billing related commsemail, post, do_not_send.
A flag indiciating if billing is enabled for the service user.
The service user's broadcare number.
The date/time the service user was created.
The date/time at which the service user left the day care service at the location.
Any notes recorded when the user was discharged from day care.
The reason for leaving given when/if the service user was discharged from day care.
The status of the service user as a day care user; active, inactive.
The use of day care by the service user; exclusive, inclusive, not_used.
The date/time at which the service user was deactivated (left the location, if they have left).
Flag indicating that the service user has dementia.
Flag indicating that the service user has dementia with challenging behaviour.
Flag indicating that the service user has dementia and is prone to wander.
The service user's date of birth.
A list of email addresses to send invoices (and related documents) to.
Flag indiciating the service user is receiving end of life (palliative) care.
The service user's first name.
The date FNC was applied for for the service user.
The status of any FNC (NHS-funded nursing care) application for the service user; not_applicable, applied_for, granted, declined.
Date/Time indicating if and when the service user's funding was flagged as at risk.
The type of funding in place for the service user; private, local_authority, local_authority_top_up, chc, chc_lifestyle, block_bed, dta_spot, not_sure.
A flag indicating that while billing is enabled for the service user they cannot appear as an option for new contracts or invoices.
A list of predefined service user's genders: male, female, non_binary, transgender, intersex.
If one or more of the service users genders are not present in the predefined gender set then additional gender terms can be given as other genders.
The age given for the service user if the date of birth isn't known.
A flag indicating if the service user has an direct debit mandate in place (in any state, pending, active or pending cancellation).
A list of fields to identify a service user with when generating a line item for the service user in an invoice for the service useraccount_code, broadcare_number, full_name, initials, nhs_number, patient_id, ref.
A flag indicating that the billing party wants to receive billing comms (invoices, statements, etc.) in larger print.
The service user's last name.
Any notes recorded when the user was discharged.
The Id of the location this service user is a client of.
The location contact that should be billed for the service user's expenses.
The geographical position of the service user as longitude/latitude coordinates.
A minimum ledger balance (in pence) below which a balance alert for this service user should be sent. If set, this balance overrides the min balance set for service users against the account.
The service user's mobile number.
Flag indicating that the service user is bed bound.
Flag indicating that the service user can walk unaided.
Flag indicating that the service user requires a hoist or aid getting out of bed.
Flag indicating that the service user uses a walking stick.
Flag indicating that the service user uses a wheelchair.
The date/time the service user was modified.
The service user's national insurance number.
The service user's NHS number.
Any additional notes regarding the service user.
The Id of the @(service user|service user's) partner within the care home. Service users can share a room with their partner.
A generic Id, (or code, reference, etc.) for the service user.
The method the billing party is expected to use for making paymentscard, cash, cheque, standing_order, direct_debit, bac.
The service user's postal address.
Address line 1 (e.g. house name/number).
Address line 2 (e.g. street).
Town, city or village.
County.
Postal code.
Country.
A name preferred by the service user.
The reason for leaving given when/if the service user was discharged.
A unique numeric reference for the service user.
Flag indicating that the service user is registered as blind.
A list of predefined service user's religions: no_religion, christian, buddhist, hindu, jewish, muslim, sikh.
If one or more of the service users religions are not present in the predefined religion set then additional religion terms can be given as other religions.
Flag indicating that a balance alert should be sent for the service user when their balance is low.
The service the service user requires; assisted_living, residential_home, nursing_home, independent_living, learning_disability_care, bariatric_care, specialist_care, home_care, live_in_care.
The service user contact that should be billed for the service user's expenses.
The Id of the care enquiry the service user was converted from.
A reference to display on statements for this billing party.
The service user's current status; pending, active, inactive.
The service user's street address.
Address line 1 (e.g. house name/number).
Address line 2 (e.g. street).
Town, city or village.
County.
Postal code.
Country.
The service user's title.
The Id of the service user this service user was duplicated from when transferred to this location.
Flag indicating that the service user is visually impaired.
{
"_id": "69a9e47783e6ab081d8eda64",
"account_code": "AM0404",
"anonymized": null,
"assistance_with_dressing": true,
"assistance_with_eating": true,
"assistance_with_medication": false,
"assistance_with_personal_care": true,
"bill_self_for_expenses": true,
"billing_comms_preference": null,
"billing_enabled": true,
"broadcare_number": null,
"created": "2026-03-05 20:15:51",
"day_care_deactivated": null,
"day_care_leaving_notes": null,
"day_care_reason_for_leaving": null,
"day_care_status": "inactive",
"day_care_use": "not_used",
"deactivated": null,
"dementia": false,
"dementia_challenging_behaviour": null,
"dementia_prone_to_wander": null,
"dob": null,
"email_invoices_to": null,
"end_of_life_care": false,
"first_name": "Anna",
"fnc_application_date": null,
"fnc_application_status": null,
"funding_at_risk": null,
"funding_type": "chc",
"future_billing_disabled": null,
"genders": [
"female"
],
"genders_other": null,
"given_age": 100,
"has_direct_debit_mandate": null,
"invoices_service_user_id_fields": null,
"large_print_requested_for_billing": null,
"last_name": "Murphy",
"leaving_notes": "",
"location": "69a9e47283e6ab081d8ecbca",
"location_contact_for_expenses": null,
"lon_lat": null,
"min_ledger_balance": null,
"mobile": null,
"mobility_bed_bound": null,
"mobility_can_walk_unaided": true,
"mobility_requires_aid_or_hoist": null,
"mobility_uses_stick": null,
"mobility_uses_wheelchair": null,
"modified": "2026-03-05 20:15:51",
"national_insurance_number": null,
"nhs_number": null,
"notes": "Anna is mobile but her legs feel heavy and she tends to shuffle/furniture walk. Anna prefers not to use a frame but does have one and she will need help standing as it is an effort.\n\nAnna needs support with personal care and dressing.",
"partner_in_care_home": null,
"patient_id": null,
"payment_method": "cash",
"postal_address": null,
"preferred_name": null,
"reason_for_leaving": null,
"ref": "404",
"registered_blind": null,
"religions": [
"jewish"
],
"religions_other": null,
"send_balance_alert": null,
"service": "nursing_home",
"service_user_contact_for_expenses": null,
"source_care_enquiry": null,
"statement_ref": null,
"status": "active",
"street_address": {
"address_1": "",
"address_2": "",
"country": "",
"county": "",
"postcode": "",
"town": ""
},
"title": "",
"transferred_from": null,
"visually_impaired": false
}
A unique account code for service user. If not specified an account code will be generated automatically for the service user.
A boolean indicating if the service user needs assistance with dressing.
A boolean indicating if the service user needs assistance with eating.
A boolean indicating if the service user needs assistance with their medication.
A boolean indicating if the service user needs assistance with personal care.
A broadcare number assigned to the service user.
A boolean indicating if the service user has dementia.
A boolean indicating that the service user has dementia with challenging behaviour.
A boolean indicating that the service user has dementia and is prone to wander.
The service user's date of both, if not given then a given age must be provided.
A boolean indicating that the service user is receiving end of life care.
The service user's first name.
The date FNC was applied for, only applicable if fnc_application_status is set to applied_for.
The status of the service user's FNC applciation. Only applicable if the service is set to nursing_home.
The type of funding in place to fund the service user's care.
The service user's gender.
Any other genders for the service user not defined in the predefined list of genders.
The service user's estimated age, if not given then a date of birth must be provided.
The service user's last name.
The Id of the location the service user resides at.
The service users's mobile number.
A boolean indicating if the service user is bed bound.
A boolean indicating if the service user can walk unaided.
A boolean indicating if the service user requires a hoist or aid getting out of bed.
A boolean indicating if the service user uses a walking stick.
A boolean indicating if the service user uses a wheelchair.
The service user's National Insurance Number (NIN).
The service user's NHS number.
Any additional notes regarding the service user.
The service user's patient Id, generic Id, (or code, reference, etc.) for the service user.
The service users's phone number. Only applicable for day care service users, required for day care users.
A name preferred by the service user.
A unique numeric reference for the service user.
A boolean indicating if the service user is registered as blind.
The care service required by the service user.
Address line 1 (e.g. house name/number).
Address line 2 (e.g. street).
Country.
County.
Postal code.
Town, city or village.
The service user's title, common values include: Mr, Mrs, Miss, Dr, Rev.
A boolean indicating if the service user is visual impaired.
Returns the care enquiry object created.
var serviceUser = apiClient.Request(
HttpMethod.Put,
"service-users",
null,
new MultiValueDict()
.Add("account_code", "MT123")
.Add("assistance_with_dressing", "yes")
.Add("assistance_with_medication", "yes")
.Add("assistance_with_personal_care", "yes")
.Add("broadcare_number", "4857773456")
.Add("day_care_use", "not_used")
.Add("dementia", "yes")
.Add("dementia_challenging_behaviour", "yes")
.Add("dob", "1932-05-03")
.Add("first_name", "Margaret")
.Add("fnc_application_date", "2025-04-02")
.Add("fnc_application_status", "applied_for")
.Add("funding_type", "private")
.Add("genders", "female")
.Add("last_name", "Thompson")
.Add("location", location_id)
.Add("mobile", "07969813976")
.Add("mobility_uses_stick", "yes")
.Add("national_insurance_number", "QQ123456B")
.Add("nhs_number", "485 777 3456")
.Add(
"notes",
"Requires support with morning and evening routines. Mild " +
"vascular dementia diagnosed in the last year. Daughter " +
"visits weekly. Enjoys knitting and listening to classical " +
"music."
)
.Add("preferred_name", "Maggie")
.Add("ref", "123")
.Add("religions", "christian")
.Add("service", "nursing_home")
.Add("title", "Mrs")
.Add("visually_impaired", "yes")
);
const careEnquiry = await apiClient.request(
"PUT",
"service-users",
{
"data": {
"account_code": "MT123",
"assistance_with_dressing": "yes",
"assistance_with_medication": "yes",
"assistance_with_personal_care": "yes",
"broadcare_number": "4857773456",
"day_care_use": "not_used",
"dementia": "yes",
"dementia_challenging_behaviour": "yes",
"dob": "1932-05-03",
"first_name": "Margaret",
"fnc_application_date": "2025-04-02",
"fnc_application_status": "applied_for",
"funding_type": "private",
"genders": ["female"],
"last_name": "Thompson",
"location": location_id,
"mobile": "07969813976",
"mobility_uses_stick": "yes",
"national_insurance_number": "QQ123456B",
"nhs_number": "485 777 3456",
"notes": (
"Requires support with morning and evening routines. Mild " +
"vascular dementia diagnosed in the last year. Daughter " +
"visits weekly. Enjoys knitting and listening to classical " +
"music."
),
"preferred_name": "Maggie",
"ref": "123",
"religions": ["christian"],
"service": "nursing_home",
"title": "Mrs",
"visually_impaired": "yes"
}
}
)
<?php
$service_user = $api_client->request(
'PUT',
'service-users',
[
'account_code'=>'MT123',
'assistance_with_dressing'=>'yes',
'assistance_with_medication'=>'yes',
'assistance_with_personal_care'=>'yes',
'broadcare_number'=>'4857773456',
'day_care_use'=>'not_used',
'dementia'=>'yes',
'dementia_challenging_behaviour'=>'yes',
'dob'=>'1932-05-03',
'first_name'=>'Margaret',
'fnc_application_date'=>'2025-04-02',
'fnc_application_status'=>'applied_for',
'funding_type'=>'private',
'genders'=>['female'],
'last_name'=>'Thompson',
'location'=>location_id,
'mobile'=>'07969813976',
'mobility_uses_stick'=>'yes',
'national_insurance_number'=>'QQ123456B',
'nhs_number'=>'485 777 3456',
'notes'=>'Requires support with morning and evening routines. Mild '
. 'vascular dementia diagnosed in the last year. Daughter '
. 'visits weekly. Enjoys knitting and listening to classical '
. 'music.',
'preferred_name'=>'Maggie',
'ref'=>'123',
'religions'=>['christian'],
'service'=>'nursing_home',
'title'=>'Mrs',
'visually_impaired'=>'yes'
]
);
service_user = api_client(
'PUT',
'service-users',
data={
'account_code': 'MT123',
'assistance_with_dressing': 'yes',
'assistance_with_medication': 'yes',
'assistance_with_personal_care': 'yes',
'broadcare_number': '4857773456',
'day_care_use': 'not_used',
'dementia': 'yes',
'dementia_challenging_behaviour': 'yes',
'dob': dob.isoformat(),
'first_name': 'Margaret',
'fnc_application_date': fnc_applied_for.isoformat(),
'fnc_application_status': 'applied_for',
'funding_type': 'private',
'genders': ['female'],
'last_name': 'Thompson',
'location': location_id,
'mobile': '07969813976',
'mobility_uses_stick': 'yes',
'national_insurance_number': 'QQ123456B',
'nhs_number': '485 777 3456',
'notes': (
'Requires support with morning and evening routines. Mild '
'vascular dementia diagnosed in the last year. Daughter '
'visits weekly. Enjoys knitting and listening to classical '
'music.'
),
'preferred_name': 'Maggie',
'ref': '123',
'religions': ['christian'],
'service': 'nursing_home',
'title': 'Mrs',
'visually_impaired': 'yes'
}
)
service_user = api_client.request(
'PUT',
'service-users',
params: {
'account_code' => 'MT123',
'assistance_with_dressing' => 'yes',
'assistance_with_medication' => 'yes',
'assistance_with_personal_care' => 'yes',
'broadcare_number' => '4857773456',
'day_care_use' => 'not_used',
'dementia' => 'yes',
'dementia_challenging_behaviour' => 'yes',
'dob' => '1932-05-03',
'first_name' => 'Margaret',
'fnc_application_date'=>'2025-04-02',
'fnc_application_status' => 'applied_for',
'funding_type' => 'private',
'genders' => ['female'],
'last_name' => 'Thompson',
'location' => location_id,
'mobile' => '07969813976',
'mobility_uses_stick' => 'yes',
'national_insurance_number' => 'QQ123456B',
'nhs_number' => '485 777 3456',
'notes' => 'Requires support with morning and evening routines. Mild ' +
'vascular dementia diagnosed in the last year. Daughter ' +
'visits weekly. Enjoys knitting and listening to classical ' +
'music.',
'preferred_name' => 'Maggie',
'ref' => '123',
'religions' => ['christian'],
'service' => 'nursing_home',
'title' => 'Mrs',
'visually_impaired' => 'yes'
}
)
{
"_id": "69a9e48f9c07865d03f62a4f",
"account_code": "MT123",
"assistance_with_dressing": true,
"assistance_with_eating": false,
"assistance_with_medication": true,
"assistance_with_personal_care": true,
"broadcare_number": "4857773456",
"created": "2026-03-05 20:16:15",
"day_care_status": "inactive",
"day_care_use": "not_used",
"dementia": true,
"dementia_challenging_behaviour": true,
"dementia_prone_to_wander": false,
"dob_str": "1946-03-25",
"end_of_life_care": "",
"first_name": "Margaret",
"fnc_application_date_str": "2026-02-17",
"fnc_application_status": "applied_for",
"funding_type": "private",
"genders": [
"female"
],
"genders_other": "",
"given_age": null,
"last_name": "Thompson",
"location": "69a9e47283e6ab081d8ecbca",
"mobile": "07969813976",
"mobility_can_walk_unaided": false,
"modified": "2026-03-05 20:16:15",
"national_insurance_number": "QQ123456B",
"nhs_number": "485 777 3456",
"notes": "Requires support with morning and evening routines. Mild vascular dementia diagnosed in the last year. Daughter visits weekly. Enjoys knitting and listening to classical music.",
"patient_id": "",
"preferred_name": "Maggie",
"ref": "123",
"registered_blind": false,
"religions": [
"christian"
],
"religions_other": "",
"service": "nursing_home",
"status": "pending",
"street_address": {
"address_1": "",
"address_2": "",
"country": "",
"county": "",
"postcode": "",
"town": ""
},
"title": "Mrs",
"visually_impaired": true
}
Return a list of service users.
['_id']
A list of attributes to include for fetched objects.
unset
A filter that allows service users to be filtered by whether the enquiry is anonymized.
A filter that accepts a list of status a day care service user can be in and filters service users by their current day care status.
A filter that accepts a list of a day care uses and filters service users by their current use of day care.
A filter that accepts a list of Ids and filters the items returned to those with an Id in the list.
A filter that accepts a list of location Ids and filters service users by the location they are a client of.
A filter that accepts a date/time and filters the items returned to those modified after the date/time.
A filter that accepts a date/time and filters the items returned to those modified before the date/time.
A case insensitive keyword filter applied to the following fields; ref, full_name.
A filter that accepts a list of status a service user can be in and filters service users by their current status.
1
The page number to fetch.
10
The number of items to return per page.
_id
A list of fields the returned items can be sorted by. Fields prefixed with minus (-) sign are sorted in descending order.
Returns a page of service users.
var serviceUsers = apiClient.Request(
HttpMethod.Get,
"service-users",
new MultiValueDict()
.Add("attributes", "ref", "first_name", "last_name")
.Add("filters-day_care_use", "not_used")
.Add("filters-status", "pending", "active")
.Add("sort_by", "full_name")
);
const serviceUsers = await apiClient.request(
"GET",
"service-users",
{
"params": {
"attributes": ["ref", "first_name", "last_name"],
"filters-day_care_use": ["not_used"],
"filters-status": ["pending", "active"],
"sort_by": "full_name"
}
}
)
<?php
$service_users = $api_client->request(
'GET',
'service-users',
[
'attributes'=>['ref', 'first_name', 'last_name'],
'filters-day_care_use'=>['not_used'],
'filters-status'=>['pending', 'active'],
'sort_by'=>'full_name'
]
);
service_users = api_client(
'GET',
'service-users',
params={
'attributes': ['ref', 'first_name', 'last_name'],
'filters-day_care_use': ['not_used'],
'filters-status': ['pending', 'active'],
'sort_by': 'full_name'
}
)
service_users = api_client.request(
'GET',
'service-users',
params: {
'attributes' => ['ref', 'first_name', 'last_name'],
'filters-day_care_use' => ['not_used'],
'filters-status' => ['pending', 'active'],
'sort_by' => 'full_name'
}
)
{
"item_count": 62,
"items": [
{
"_id": "69a9e47783e6ab081d8eda64",
"first_name": "Anna",
"last_name": "Murphy",
"ref": "404"
},
{
"_id": "69a9e47783e6ab081d8eda4e",
"first_name": "Barry",
"last_name": "Taylor",
"ref": "398"
},
{
"_id": "69a9e47783e6ab081d8eda1c",
"first_name": "Beth",
"last_name": "Bishop",
"ref": "385"
},
{
"_id": "69a9e47783e6ab081d8edb08",
"first_name": "Brian",
"last_name": "Shaw",
"ref": "455"
},
{
"_id": "69a9e47783e6ab081d8eda4a",
"first_name": "Bruce",
"last_name": "Bruce",
"ref": "397"
},
{
"_id": "69a9e47783e6ab081d8edabc",
"first_name": "Carol",
"last_name": "Watson",
"ref": "430"
},
{
"_id": "69a9e47783e6ab081d8eda86",
"first_name": "Carol",
"last_name": "Wilson",
"ref": "413"
},
{
"_id": "69a9e47783e6ab081d8eda3c",
"first_name": "Carolyn",
"last_name": "Moss",
"ref": "393"
},
{
"_id": "69a9e47783e6ab081d8eda18",
"first_name": "Charlene",
"last_name": "Evans",
"ref": "384"
},
{
"_id": "69a9e47783e6ab081d8eda46",
"first_name": "Damien",
"last_name": "Ali",
"ref": "396"
}
],
"page": 1,
"page_count": 7,
"per_page": 10
}
var serviceUser = apiClient.Request(
HttpMethod.Get,
$"service-users/{serviceUserId}"
);
const serviceUser = await apiClient.request(
"GET",
`service-users/${serviceUserId}`
);
<?php
$service_user = $api_client->request(
'GET',
'service-users/' . $service_user_id
);
service_user = api_client('GET', f'service-users/{service_user_id}')
service_user = api_client.request('GET', "service-users/#{service_user_id}")
{
"_id": "69a9e47783e6ab081d8eda64",
"account_code": "AM0404",
"anonymized": null,
"assistance_with_dressing": true,
"assistance_with_eating": true,
"assistance_with_medication": false,
"assistance_with_personal_care": true,
"bill_self_for_expenses": true,
"billing_comms_preference": null,
"billing_enabled": true,
"broadcare_number": null,
"created": "2026-03-05 20:15:51",
"day_care_deactivated": null,
"day_care_leaving_notes": null,
"day_care_reason_for_leaving": null,
"day_care_status": "inactive",
"day_care_use": "not_used",
"deactivated": null,
"dementia": false,
"dementia_challenging_behaviour": null,
"dementia_prone_to_wander": null,
"dob": null,
"email_invoices_to": null,
"end_of_life_care": false,
"first_name": "Anna",
"fnc_application_date": null,
"fnc_application_status": null,
"funding_at_risk": null,
"funding_type": "chc",
"future_billing_disabled": null,
"genders": [
"female"
],
"genders_other": null,
"given_age": 100,
"has_direct_debit_mandate": null,
"invoices_service_user_id_fields": null,
"large_print_requested_for_billing": null,
"last_name": "Murphy",
"leaving_notes": "",
"location": "69a9e47283e6ab081d8ecbca",
"location_contact_for_expenses": null,
"lon_lat": null,
"min_ledger_balance": null,
"mobile": null,
"mobility_bed_bound": null,
"mobility_can_walk_unaided": true,
"mobility_requires_aid_or_hoist": null,
"mobility_uses_stick": null,
"mobility_uses_wheelchair": null,
"modified": "2026-03-05 20:15:51",
"national_insurance_number": null,
"nhs_number": null,
"notes": "Anna is mobile but her legs feel heavy and she tends to shuffle/furniture walk. Anna prefers not to use a frame but does have one and she will need help standing as it is an effort.\n\nAnna needs support with personal care and dressing.",
"partner_in_care_home": null,
"patient_id": null,
"payment_method": "cash",
"postal_address": null,
"preferred_name": null,
"reason_for_leaving": null,
"ref": "404",
"registered_blind": null,
"religions": [
"jewish"
],
"religions_other": null,
"send_balance_alert": null,
"service": "nursing_home",
"service_user_contact_for_expenses": null,
"source_care_enquiry": null,
"statement_ref": null,
"status": "active",
"street_address": {
"address_1": "",
"address_2": "",
"country": "",
"county": "",
"postcode": "",
"town": ""
},
"title": "",
"transferred_from": null,
"visually_impaired": false
}