Get Work Order | Coperniq API

const url = 'https://api.coperniq.io/v1/work-orders/1';
const options = {method: 'GET', headers: {'x-api-key': '<apiKey>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "id": 2005936,
  "uid": 549,
  "templateId": 889194,
  "createdAt": "2026-02-23T16:16:05.251-08:00",
  "updatedAt": "2026-04-15T10:00:00.000-07:00",
  "title": "[BP] Tech site audit (post-sale)",
  "description": "<p>Complete Checklist Items below and fill out any applicable Forms.</p>",
  "priority": 2,
  "startDate": null,
  "startDateAllDay": false,
  "endDate": "2026-04-16T12:00:00-07:00",
  "endDateAllDay": true,
  "completedAt": null,
  "isActive": true,
  "isCompleted": false,
  "isField": true,
  "labels": [],
  "project": {
    "id": 789225,
    "uid": 42,
    "title": "Michael Scott",
    "address": [
      "123 North Main Avenue, Scranton, PA 18504"
    ],
    "stage": null
  },
  "assignee": {
    "id": 10299,
    "firstName": "Jane",
    "lastName": "Doe"
  },
  "collaborators": [],
  "visits": {
    "visits": []
  },
  "statuses": [],
  "status": {
    "id": "ASSIGNED",
    "label": "Assigned"
  },
  "checklist": [
    {
      "id": 8310528,
      "detail": "[Scheduler] Schedule Visit with Client",
      "isCompleted": false,
      "completedAt": null
    }
  ],
  "workItems": [
    {
      "type": "FORM",
      "id": 1236647,
      "completedAt": null,
      "dueDate": null,
      "isCompleted": false,
      "name": "[BP] Site Survey - Roof Mount",
      "status": "OPEN",
      "templateId": 50
    },
    {
      "type": "FILE_REQUEST",
      "id": 2556,
      "name": "Shade Report",
      "status": "IN_PROGRESS"
    }
  ],
  "isArchived": false
}

Retrieve a specific work order by ID.

Archived work orders are returned too. Check isActive: it is false for an archived work order (the deprecated isArchived field is true).

The lineItems property is returned only for service work orders on an account (parent project type ACCOUNT), and only when at least one line item exists. Otherwise the field is omitted from the JSON object.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

work_order_idintegerRequired

Work order identifier

Response

Work order details

idintegerOptional

Work order identifier

uidintegerOptional

Unique work order number within the project

templateIdintegerOptional

Template identifier for the work order

createdAtstringOptionalformat: "date-time"

Creation timestamp

updatedAtstringOptionalformat: "date-time"

Last update timestamp

titlestringOptional

Work order title

descriptionstringOptional

Work order description

priorityintegerOptional

Priority level

startDatestring or nullOptionalformat: "date-time"

Scheduled start date

startDateAllDaybooleanOptional

Whether the start date is an all-day event

endDatestring or nullOptionalformat: "date-time"

Scheduled end date

endDateAllDaybooleanOptional

Whether the end date is an all-day event

completedAtstring or nullOptionalformat: "date-time"

Timestamp when the work order was completed

isActivebooleanOptional

Whether the work order is active (not archived)

isCompletedbooleanOptional

Whether the work order is completed

isFieldbooleanOptional

Whether the work order is a field task

labelslist of objectsOptional

Labels associated with the work order

projectobjectOptional

Project associated with the work order

createdByobject or nullOptionalRead-only

User who created the work order. null when unknown. Create responses return { id } only.

assigneeobject or nullOptional

User assigned to the work order

collaboratorslist of objectsOptional

Additional users collaborating on the work order

visitsobjectOptional

Site visits associated with the work order (legacy shape)

statuseslist of objectsOptional

History of status changes and time spent in each status

statusobject or nullOptional

Current status of the work order

checklistlist of objectsOptional

Checklist items for the work order

workItemslist of objectsOptional

Work items linked to this work order via Blueprint workflow. Includes forms (FORM) and file requests (FILE_REQUEST). Returns [] when none are linked.

lineItemslist of objectsOptional

Present only for service work orders on an account (parent project type ACCOUNT), and only when at least one line item exists. Amounts are in dollars with cent precision. Replace via PUT /work-orders/{work_order_id}/line-items. Omitted from the response when not applicable or when there are no line items.

isArchivedbooleanOptionalDeprecated

Deprecated: use isActive instead. Kept for backward compatibility.

Errors

401

Unauthorized Error

404

Not Found Error