---
title: "Get Job Change History"
method: GET
path: "/jobs/{jobId}/history"
tags: ["jobs"]
---

# Get Job Change History

`GET /jobs/{jobId}/history`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/jobs/{jobId}/history`
- Auth: HTTP bearer

Use this endpoint to get a history of actions performed for a job. **Supported includes:** `createdBy`. When startDate and endDate are specified, actions returned will be filtered to those created between those dates (inclusive). This endpoint will return a paginated response starting from the given page start index. A `416 Range Not Satisfiable` error is returned when `pageStartIndex` is greater than or equal to the total number of history records. If the job has no history records, a `200 OK` is returned with an empty `items` array, echoing back the requested `pageSize` and `pageStartIndex`.

## Path parameters

- `jobId` string, uuid, required

## Query parameters

- `pageSize` integer
- `pageStartIndex` integer
- `includes` string
- `startDate` string, date
- `endDate` string, date

## Response `200`

OK

- JobActionCollection
  - `count` integer: The total number of items matching the current query.
  - `pageSize` integer: The requested or default page size.
  - `pageStartIndex` integer: The requested or default index of the first element to return.
  - `items` JobAction[]
    - `action` string: The action performed on this lead.
    - `type` 'Customer' | 'Job' | 'Lead' | 'Measurement' | 'Estimate' | 'Order' | 'Permit' | 'Payments' | 'Commission' | 'Precommission' | 'ContractWorksheet' | 'Supplement' | 'File' | 'Unspecified' | 'CommunicationHistory' | 'ContactNote' | 'JobContact' | 'Contact' | 'JobMessage' | 'ContractWorksheetStatus' | 'MortgageCheck' | 'Measurements' | 'Appointment' | 'JobEmail' | 'JobPacket' | 'Account' | 'Company' | 'User' | 'FeatureManager' | 'PermissionSettings' | 'LaborContact' | 'LaborOrder' | 'Financing' | 'JobSignatureEmail' | 'JobPaymentRequest' | 'TextMessage': The type of action.
    - `date` string: Date and time the action happened represented in UTC.
    - `createdBy` CompanyUserLink
      - `id` string, uuid: The unique GUID of the AccuLynx User.
      - `_link` string: The unique URI of the AccuLynx User.

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `416`: Range Not Satisfiable.

## Changes

- **2026-11-03** `443924b00f43`: 4 breaking, 3 warning, 2 info
  - for the `query` request parameter `pageSize`, default value `25` was removed
  - removed the required property `status` from the response with the `416` status
  - removed the required property `title` from the response with the `416` status
  - removed the required property `type` from the response with the `416` status
  - …5 more

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/jobs/:jobId/history/get.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)