Datasets · Buildertrend

Buildertrend Schedules Dataset

Schedule entries with their job, phase, dates and completion.

Record type buildertrend:schedules

Read it with List records, or the MCP tool list_dataset_records.

Request

curl -G https://api.clickr.cloud/v2/datasets/{datasetId}/records \
  -H "Authorization: Bearer $CLICKR_API_KEY" \
  --data-urlencode "limit=10"

const response = await fetch(`https://api.clickr.cloud/v2/datasets/{datasetId}/records?${new URLSearchParams({
  "limit": "10"
})}`, {
  headers: {
    Authorization: `Bearer ${process.env.CLICKR_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.clickr.cloud/v2/datasets/{datasetId}/records",
    headers={"Authorization": f"Bearer {os.environ['CLICKR_API_KEY']}"},
    params={
        "limit": "10"
    },
)
data = response.json()

Record

Example record

{
  "scheduleItemId": "9100001",
  "jobId": "7310421",
  "jobName": "Henderson Residence Addition",
  "builderId": "48213",
  "phaseId": "301",
  "phaseTitle": "Pre-construction",
  "title": "Design & engineering sign-off",
  "startDate": "2026-08-07T00:00:00",
  "endDate": "2026-08-09T00:00:00",
  "durationWorkdays": 1,
  "isHourly": false,
  "isCompleted": true,
  "completedBy": "Marcus Lee",
  "completedDate": "2026-08-09T00:00:00",
  "percentComplete": 100,
  "assignees": [
    {
      "id": "6120403",
      "name": "Marcus Lee"
    }
  ],
  "showOwner": true,
  "commentCount": 0,
  "attachedFileCount": 0,
  "isDeleted": false
}

From the sample builder, Halvorsen & Styke.

Ask Claude or ChatGPT about the same records: add https://api.clickr.cloud/mcp/playground as a connector, with no sign-in. Try it on a sample builder ›

Fields

Every field a record can carry. Filter and sort on them by name, as in filter[jobName][contains]=patel. A field without a value can be missing from a record.

scheduleItemIdstring
Buildertrend's id for the schedule item.
jobIdstring
Buildertrend's id for the job the item is on. Joins to the Buildertrend Jobs Dataset.
jobNamestring
The job's name in Buildertrend.
jobColorstring
The colour Buildertrend gives the job.
builderIdstring
Buildertrend's id for the builder account.
phaseIdstring
Buildertrend's id for the schedule phase the item belongs to.
phaseTitlestring
The name of the phase the item belongs to.
phaseColorstring
The colour Buildertrend gives the phase.
titlestring
The schedule item's name, the dated line on the job's schedule, such as Dig or Garage Frames.
colorstring
The colour Buildertrend gives the item.
startDatestring
When the item starts, as Buildertrend's local wall-clock date and time with no time zone.
endDatestring
When the item ends, as Buildertrend's local wall-clock date and time with no time zone.
durationWorkdaysnumber
The item's length in working days, counted against the job's workday calendar. It is not endDate minus startDate.
isHourlyboolean
True when the item is scheduled for times of day, false when it is an all-day item.
isCompletedboolean
Buildertrend's own completed flag for the item, so it is safe to report on. Unlike Tasks, an item that disappears is marked deleted, never complete.
completedBystring
Who marked the item complete, as Buildertrend records it.
completedDatestring
When the item was marked complete.
percentCompletenumber
How far through the item is, as Buildertrend's percent complete.
assigneesarray of objects
The people and companies assigned to the item.

assignees.idstring
Buildertrend's id for the assignee.
assignees.namestring
The person's or company's name.
confirmAcceptedCountnumber
How many subs/vendors have accepted the item when asked to confirm it.
confirmPendingCountnumber
How many subs/vendors have not yet answered a request to confirm the item.
confirmDeclinedCountnumber
How many subs/vendors have declined the item when asked to confirm it.
predecessorsarray of objects
The schedule items this one waits on. The dependency type and lag are not included.
predecessors.scheduleItemIdstring
The predecessor's id. Joins to scheduleItemId in this dataset.
predecessors.titlestring
The predecessor's title, copied in so it can be read without a lookup.
showOwnerboolean
Buildertrend's setting for whether the client may see the item.
notesstring
The item's notes, from Buildertrend's All notes field.
internalNotesstring
The item's internal notes, meant for the builder's own staff.
subNotesstring
The item's notes for subs/vendors.
ownerNotesstring
The item's notes for the client, whom Buildertrend calls the owner.
commentCountnumber
How many comments the item has.
rfiCountnumber
How many RFIs (requests for information) are linked to the item.
attachedFileCountnumber
How many files are attached to the item. The files themselves are not in this dataset.
isDeletedboolean
True once the item has been removed from the schedule in Buildertrend. Clickr keeps the record so you can see it went.
deletedAtdate and time
When Clickr saw the item removed. Only items from 3 days ago to 15 days ahead are rechecked, so a removal further out is seen later.