---
title: "Get an appointment (job) by id"
method: GET
path: "/jobs/{jobId}"
tags: ["Jobs"]
---

# Get an appointment (job) by id

`GET /jobs/{jobId}`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/jobs/{jobId}`
- Auth: API key in header `X-Api-Key`

## Path parameters

- `jobId` string, uuid, required

## Response `200`

One appointment

- Job: An appointment (job) in the company's planner — a site visit, maintenance, repair, etc. Canceled appointments are included; check `canceledAt`.
  - `id` string, uuid, required
  - `title` string, required
  - `description` string, nullable
  - `jobType` 'consultation' | 'maintenance' | 'repair' | 'emergency' | 'complaint' | 'other', required: Built-in appointment category.
  - `jobTypeId` string, uuid, nullable: The company's custom appointment type, when one is set.
  - `startAt` string, date-time, nullable
  - `endAt` string, date-time, nullable
  - `address` string, nullable: Free-text address of the appointment.
  - `contactPerson` string, nullable
  - `color` string, nullable
  - `projectId` string, uuid, nullable
  - `customerId` string, uuid, nullable
  - `assignedProfileIds` string[], required: Team members (profile ids, see `GET /team-members`) assigned to the appointment.
  - `createdByProfileId` string, uuid, nullable
  - `canceledAt` string, date-time, nullable
  - `cancellationReason` 'customer_canceled' | 'customer_unavailable' | 'no_access' | 'weather' | 'staff_unavailable' | 'rescheduled' | 'other' | 'null', nullable
  - `cancellationNote` string, nullable
  - `companyId` string, uuid, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid request — a malformed id, filter, pagination parameter or body. The body is a plain-text message naming the problem.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)