Job API List

Read the jobs you have posted, look up the allowed values for a job's fields, find the settings you can brand a job as, and check your job credit balance.

Who can use it: Enhanced and Platinum subscribers.

Every endpoint on this page accepts GET only. Base URL https://api.carehome.co.uk. Authentication, errors and support are covered in the Jobs API overview.

List your jobs

GET /index.cfm/jobs

Returns the jobs posted with your API key, newest first. A group's key also returns the jobs posted by each setting in the group. Closed jobs are left out; jobs that have expired are included, so check job_expiry_date.

Query parameters

Example request

curl "https://api.carehome.co.uk/index.cfm/jobs?api_key=YOUR_API_KEY"

Example response

200 OK. The values below are illustrative.

{
  "data": [
    {
      "job_id": 96000000001,
      "job_title": "Care Assistant (example)",
      "job_setting": "Care Home / Nursing Home",
      "job_setting_id": 10,
      "job_category": "Carer / Care Assistant / Care Support Worker",
      "job_category_id": 5,
      "job_posted_date": "2026-10-01 09:30:00",
      "job_updated_date": "2026-10-01 09:30:00",
      "job_expiry_date": "31-Oct-2026 00:00:00",
      "job_location_text": "Exampletown, ",
      "job_member_id": 65432100000,
      "job_member_name": "Example Care Home",
      "job_town_id": 12345,
      "job_town_name": "Exampletown",
      "job_type": "Full Time",
      "job_type_id": "1",
      "job_contact_name": "Example Name",
      "job_contact_url": "",
      "job_contact_email": "example@example.com",
      "job_admin_email": "example@example.com",
      "job_reference": "EXAMPLE-001",
      "job_description": "<p>An example job description.</p>",
      "job_link": "https://www.carehome.co.uk/jobs/job.cfm/id/96000000001",
      "jobs_pay_type_id": 2,
      "jobs_salary_from": 12.5,
      "jobs_salary_to": 13.5,
      "job_salary": "",
      "job_skills": "Example skill, another example skill",
      "job_accept_applicant_uk_only": 0
    }
  ],
  "error": [],
  "warn": []
}

If you have no jobs, the response is 404 with "error": ["No job record found."] and an empty data array.

Job object

A field with no value is returned as an empty string.

Get a job

GET /index.cfm/jobs/{job_id}

Returns one of your jobs. A group's key can also get a job posted by a setting in the group.

Parameters

Example request

curl "https://api.carehome.co.uk/index.cfm/jobs/96000000001?api_key=YOUR_API_KEY"

Response

200 OK with the job in data as an object, and an error array. The job has the same fields as the job object, except that:

• the pay fields are named job_pay_type_id, job_salary_from and job_salary_to (no s);
• job_location_text includes the county, for example Exampletown, Exampleshire;
• job_skills and job_accept_applicant_uk_only are not included.

Lookups

Use these to find the IDs a job needs. The values can change, so fetch them rather than hard-coding them; refreshing once a day is enough.

job_town_name is the town, county and country, for example Exampletown - Exampleshire - England.

The pay types are:

Example request

curl "https://api.carehome.co.uk/index.cfm/jobs/types?api_key=YOUR_API_KEY"

Example response

{
  "data": [
    { "job_type_id": 1, "job_type_name": "Full Time", "job_type_sequence": 10 },
    { "job_type_id": 2, "job_type_name": "Part Time", "job_type_sequence": 20 }
  ],
  "error": []
}

An unknown job_town_id returns 404 with No town record found for the job_town_id passed.; one that is not a number returns 400 with job_town_id needs to be numeric.

Settings you can brand a job as

GET /index.cfm/jobs/members
GET /index.cfm/jobs/members/{member_id}

Returns the settings and groups you can use as job_member_id when posting a job. Which ones you get depends on your API key:

• a setting's key returns that setting only;
• a group's key returns the group and each setting in it.

Query parameters

Example request

curl "https://api.carehome.co.uk/index.cfm/jobs/members?api_key=YOUR_API_KEY&search_term=example"

Example response

{
  "data": [
    {
      "member_id": 65432100000,
      "member_name": "(Self Branded) Example Care Home, Exampletown, Exampleshire, AB1 2CD [Care Home]",
      "member_is_group": 0
    }
  ],
  "error": []
}

/jobs/members/{member_id} returns one item in the same format, with a shorter member_name, or 404 if you cannot brand a job as it. A search_term shorter than three characters returns 400; a search with no matches returns 404.

Job credit balance

GET /index.cfm/jobs/credits

Returns how many job credits you have used and how many you have left. Posting a job uses one credit.

Example request

curl "https://api.carehome.co.uk/index.cfm/jobs/credits?api_key=YOUR_API_KEY"

Example response

{
  "data": {
    "job_credit_used": 12.0,
    "job_credit_balance": 8
  },
  "error": []
}