---
title: "Get the schedule board's jobs for a day"
method: GET
path: "/v1/jobs/board"
tags: ["Jobs"]
---

# Get the schedule board's jobs for a day

`GET /v1/jobs/board`

## Request

- Base URL: `https://api.bigchange.com`
- URL: `https://api.bigchange.com/v1/jobs/board`
- Auth: HTTP bearer

Retrieve a paged collection of the scheduled jobs that overlap one day in the user's time zone, completed jobs included, for the schedule board's rows. A job appears once for its resource and once for each assistant. The user's resource, vehicle and job category restrictions are applied. Ordered by planned start. Requires the user to have the right to view allocated jobs (required scope jobs:read)

## Query parameters

- `date` string, date
- `useActualTimes` boolean
- `resourceId` integer[]
- `pageNumber` integer
- `pageSize` integer

## Headers

- `Customer-Id` integer, required

## Response `200`

OK

- PagedResponseReadBoardJobModel: A paged collection of items
  - `items` ReadBoardJobModel[]: The items returned for the requested page
    - `jobId` integer: The unique identifier of the job
    - `resourceId` integer, nullable: The unique identifier of the resource whose row the job is on: the job's resource, or an assistant
    - `isAssisting` boolean: Whether the resource is on the job as an assistant
    - `plannedStartAt` string, date-time, nullable: The UTC date and time the job is planned to start
    - `plannedDurationMinutes` integer: The planned duration of the job, in minutes
    - `actualStartAt` string, date-time, nullable: The UTC date and time the job was started on the device, if it has been
    - `actualEndAt` string, date-time, nullable: The UTC date and time the job was completed on the device, if it has been
    - `plannedTravelMinutes` integer, nullable: The planned travel time to the job from the resource's previous job or start point, in minutes
    - `plannedReturnTravelMinutes` integer, nullable: The planned travel time of the job's return journey, in minutes
    - `actualTravelMinutes` integer, nullable: The driving time the device recorded for the job, in whole minutes, once the job is completed on the device
  - `pageNumber` integer: The page number of the response where 1 is the first page
  - `pageSize` integer: The number of items requested for the current page
  - `pageItemCount` integer: The number of items returned in the current page

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-11-16** `218eba15fa2b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigchange/apis/bigchange-dx/changes/v1/jobs/board/get.md)

---

[API](https://skmtc.dev/bigchange/apis/bigchange-dx.md) - [All operations](https://skmtc.dev/bigchange/apis/bigchange-dx/llms.txt) - [OpenAPI document](https://skmtc.dev/bigchange/apis/bigchange-dx/revisions/e98326ed0f00?raw)
