Location contact people

A person at a location contact.

The location contact person object

Attributes

  • _id
    string

    A unique Id for the location contact person.

  • created
    string

    The date/time the location contact person was created.

  • email
    string

    The location contact person's email address.

  • first_name
    string

    The location contact person's first name.

  • job_title
    string

    The location contact's job title address.

  • last_name
    string

    The location contact person's last name.

  • location_contact
    string

    The Id of the location contact this person works at.

  • location_contact_department
    string

    The Id of the department this person works in.

  • locations
    list of strings

    A list of locations the location contact person relates to.

  • mobile
    string

    The location contact person's mobile number.

  • modified
    string

    The date/time the location contact person was created.

  • notes
    string

    Additional notes for the location contact person.

  • phone
    string

    The location contact person's phone number.

  • title
    string

    The location contact person's title.

The location contact person object
{
    "_id": "6a56c6c169209a7d72be9c38",
    "created": "2026-07-14 23:31:13",
    "email": "lena.calloway@oxfordshire.gov.uk",
    "first_name": "Lena",
    "job_title": "Social worker",
    "last_name": "Calloway",
    "location_contact": "6a56c6c169209a7d72be9c24",
    "location_contact_department": null,
    "locations": [
        "6a56c6c169209a7d72be9bfe"
    ],
    "mobile": null,
    "modified": "2026-07-14 23:31:13",
    "notes": null,
    "phone": "01865 223455",
    "title": "Mrs"
}

List all location contact persons

Return a list of location contact perosns.

Parameters

  • attributes
    optional
    default ['_id']

    A list of attributes to include for fetched objects.

  • filters-ids
    optional

    A filter that accepts a list of Ids and filters the items returned to those with an Id in the list.

  • filters-location
    optional

    A filter that accepts a list of location Ids and filters location contact persons by the location they relate to.

  • filters-location_contact
    optional

    A filter that accepts a list of location contact Ids and filters location contact persons by the location contact they relate to.

  • filters-modified_after
    optional

    A filter that accepts a date/time and filters the items returned to those modified after the date/time.

  • filters-modified_before
    optional

    A filter that accepts a date/time and filters the items returned to those modified before the date/time.

  • filters-q
    optional

    A case insensitive keyword filter applied to the following fields; full_name.

  • page
    optional
    default 1

    The page number to fetch.

  • per_page
    optional
    default 10

    The number of items to return per page.

  • sort_by
    optional
    default _id

    A list of fields the returned items can be sorted by. Fields prefixed with minus (-) sign are sorted in descending order.

    • _id
    • created
    • full_name
    • modified

Response

Returns a page of location contact persons.

GET
/v1/location-contact-persons
var locationContactPersons = apiClient.Request(
    HttpMethod.Get,
    "location-contact-persons",
    new MultiValueDict()
        .Add("attributes", "first_name", "last_name")
        .Add("filters-location", locationId)
);
const locationContactPersons = await apiClient.request(
    "GET",
    "location-contact-persons",
    {
        "params": {
            "attributes": ["first_name", "last_name"],
            "filters-location": [locationId]
        }
    }
)
<?php

$location_contact_persons = $api_client->request(
    'GET',
    'location-contact-persons',
    [
        'attributes'=>['first_name', 'last_name'],
        'filters-location'=>[location_id]
    ]
);
location_contact_persons = api_client(
    'GET',
    'location-contact-persons',
    params={
        'attributes': ['billing_fao', 'name'],
        'filters-location': [location_id]
    }
)
location_contacts_persons = api_client.request(
    'GET',
    'location-contact-persons',
    params: {
        'attributes' => ['first_name', 'last_name'],
        'filters-location' => [location_id]
    }
)
Response
{
    "item_count": 0,
    "items": [],
    "page": 1,
    "page_count": 1,
    "per_page": 10
}

Retrieve a location contact person

Retreive a location contact person object.

Response

Returns a location contact person object.

GET
/v1/location-contact-persons/<location_contact_person_id>
var locationContactPerson = apiClient.Request(
    HttpMethod.Get,
    $"location-contact-persons/{locationContactPersonId}"
);
const locationContactPerson = await apiClient.request(
    "GET",
    `location-contact-persons/${locationContactPersonId}`
)
<?php

$location_contact_person = $api_client->request(
    'GET',
    'location-contact-persons/' . $location_contact_person_id
);
location_contact_person = api_client(
    'GET',
    f'location-contact-persons/{location_contact_person_id}'
)
location_contact_person = api_client.request(
    'GET',
    "location-contact-persons/#{location_contact_person_id}"
)
Response
{
    "_id": "6a56c6c169209a7d72be9c38",
    "created": "2026-07-14 23:31:13",
    "email": "lena.calloway@oxfordshire.gov.uk",
    "first_name": "Lena",
    "job_title": "Social worker",
    "last_name": "Calloway",
    "location_contact": "6a56c6c169209a7d72be9c24",
    "location_contact_department": null,
    "locations": [
        "6a56c6c169209a7d72be9bfe"
    ],
    "mobile": null,
    "modified": "2026-07-14 23:31:13",
    "notes": null,
    "phone": "01865 223455",
    "title": "Mrs"
}