---
title: "Retrieve a list of installer jobs"
method: GET
path: "/api/v1/installer-jobs"
tags: ["Installer Jobs"]
---

# Retrieve a list of installer jobs

`GET /api/v1/installer-jobs`

Required scope: `installer-jobs:read`

## Query parameters

- `page` integer
- `perPage` integer
- `from` string, date
- `to` string, date
- `siteId` integer, nullable — Allows to filter list of installer jobs by a site id
- `teamId` integer, nullable — Allows to filter list of installer jobs by a team id.
- `includeDeleted` boolean, nullable — If true, deleted installer jobs will be included in the response.

## Response `200`

List of installer jobs that match the criteria

- OffsetBasedResponse54
  - `data` InstallerJob[], required
    - `id` integer — Id of this installer job
    - `siteId` integer — Id of the site related to this installer job
    - `operator` Operator, required
      - `id` integer — ID of the operator
      - `name` string, required — Name of operator
      - `identifier` string, required — Identifier of operator
      - `partnerId` integer, nullable — Id of the partner
      - `vatNumber` string, nullable — VAT number
    - `teamId` integer — Id of the team of this installer job
    - `description` string, nullable — Description of this installer job, will be visible to the installer
    - `publicLink` string, required — Public link of this installer job, shareable with the installer
    - `chargePointCount` integer — Number of charge points included in this installer job
    - `chargePointActiveCount` integer — Number of active (finished) charge points in this installer job
    - `email` string, nullable — Email of the installer assigned to this job.
    - `tasks` InstallerJobTask[], required — List of tasks of this installer job
      - `id` integer — Id of this installer job task
      - `installerJobId` integer — Id of the installer job of this installer job task
      - `chargePointId` integer — Id of the charge point to install
      - `serialNumber` string, nullable — Serial number of the charge point to install
      - `connector` integer — Connector ID of the charge point to install
      - `note` string, nullable — Note of this installer job task, will be visible to the installer
      - `installerNote` string, nullable — Note provided by installer during this installer job task
      - `activeAt` string, date-time, nullable — Date this installer job task was active
      - `createdAt` string, date-time, required — Creation date of this installer job task
      - `updatedAt` string, date-time, nullable — Date this installer job task was last updated
      - `deletedAt` string, date-time, nullable — Date this installer job task was deleted
    - `completedAt` string, date-time, nullable — Date this installer job was completed
    - `createdAt` string, date-time, required — Date this installer job was created
    - `updatedAt` string, date-time, nullable — Date this installer job was updated
    - `deletedAt` string, date-time, nullable — Date this installer job was deleted
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)