Enquiry Data

Retrieve the enquiries your settings have received through carehome.co.uk as JSON, so you can import them into your own systems.

Who can use it: Enhanced and Platinum subscribers. By using the API you agree to our API terms of use.

List enquiries

GET /index.cfm/enquiry

Base URL https://api.carehome.co.uk. Authentication, errors and support are covered in the Enquiry API overview.

Returns every enquiry that matches your filters, oldest first. There is no pagination; all matching enquiries are returned in one response, so use dateFrom and dateTo to keep responses small. A setting's key returns that setting's enquiries; a group's key returns enquiries for the group and every active setting in it.

Query parameters

Send the parameters in the query string. Parameter names are not case-sensitive.

Dates

We recommend the format YYYY-MM-DDTHH:MM:SS, for example 2026-01-25T09:10:00. A date without a time means midnight at the start of that day, so dateTo=2026-01-31 does not include enquiries sent during 31 January; use dateTo=2026-01-31T23:59:59 instead.

Dates and times are UK time (Europe/London, GMT or BST). If you add a UTC offset, such as Z or +01:00, the value is read as that exact moment instead.

Example request

curl "https://api.carehome.co.uk/index.cfm/enquiry?api_key=YOUR_API_KEY&dateFrom=2026-01-01T00:00:00&dateTo=2026-01-31T23:59:59&categoryId=4,20,62"

Example response

200 OK, Content-Type: application/json. The values below are illustrative.

{
  "data": [
    {
      "id": 12345678,
      "category ": {
        "id": 4,
        "name": "Care Enquiry"
      },
      "category": {
        "id": 4,
        "name": "Care Enquiry"
      },
      "member": {
        "postcode": "AB1 2CD",
        "id": 65432100000,
        "name": "Example Care Home"
      },
      "group": {
        "postcode": "AB1 2CE",
        "id": 65432100001,
        "name": "Example Care Group"
      },
      "to": "enquiries@example.com",
      "from": "example@example.com",
      "date": "2026-01-15 14:05:09",
      "content": "Example message text.",
      "firstName": "Example",
      "surname": "Name",
      "address1": "",
      "address2": "",
      "address3": "",
      "town": "",
      "postcode": "",
      "telephone": "01234 567890",
      "isAnonymised": "No",
      "categorySpecificData": {
        "fundingType": "Self funding (Private)",
        "agentOfferedATour": null,
        "whoIsNeedOfCare": "A parent",
        "stayLengthType": "Permanent/Long-term",
        "howSoonType": "1 - 3 months",
        "enquirerInterestedInATour": true,
        "careNeededType": "Older person residential",
        "personNeedingCareName": null,
        "comment": "Example message text."
      }
    }
  ],
  "error": []
}

If no enquiries match, the response is 404 with "data": [] and "error": ["No record found."]. Treat this as an empty result, not a failure.

Enquiry object

categorySpecificData

Which keys appear depends on the enquiry's category. A key that is present can still be an empty string or null when the person did not answer that question.

General Enquiry (1) and Job Enquiry (5)

Brochure Request (2), Care Enquiry (4) and Care Enquiry via Care Help Team (63)

Onsite Tour/Consultation Request (20) and Remote Tour/Consultation Request (21)

Example:

"categorySpecificData": {
  "bookingType": "Onsite Tour/Consultation",
  "bookingDate": "Monday 2nd February 2026",
  "bookingTime": "10:30",
  "bookingDateTime": "2026-02-02T10:30:00Z",
  "comment": "Example message text.",
  "whoIsNeedOfCare": "A parent",
  "careNeededType": "Older person nursing",
  "howSoonType": "1 week - 1 month",
  "stayLengthType": "Respite/Short-term",
  "fundingType": "Local Authority"
}

Once a tour request has been anonymised, categorySpecificData is an empty object.

Care Enquiry via Phone (62)

Anonymised enquiries

Enquiries are anonymised three years after they were sent, or straight away if the person asks us to erase their data. By default they are left out of results; add excludeAnonymised=false to include them. In an anonymised enquiry:

• isAnonymised is "Yes".
• to and from are anon@carehome.co.uk.
• content, firstName, surname and telephone are anon. Address fields are anon if they had a value, otherwise an empty string.
• In categorySpecificData, the care details are empty strings or null, comment (if present) is anon, and tour requests have an empty object.

Validation errors

A problem with the query returns 404 with "data": [] and the reasons in error:

{
  "data": [],
  "error": ["Invalid 'categoryId'. Values can only be in the following list [1,2,4,5,20,21,62,63]"]
}