---
title: "GET /api/jobs"
method: GET
path: "/api/jobs"
tags: ["api", "jobs"]
---

# GET /api/jobs

`GET /api/jobs`

Get all jobs

## Query parameters

- `skip` number, float — The number of objects to skip for the requested result
- `top` number, float — A limit on the number of objects to be returned. Can range between 1 and 1000.
- `type` 'import' | 'export' | 'delete' | 'scheduledJob' | 'transformJob' — The type of an job to filter for
- `status` 'SCHEDULED' | 'RUNNING' | 'FAILED' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' — The status of an job to filter for

## Response `200`

OK

- GETJobsGetAllJobs200Response
  - `docs` union[]
    - union
      - object
        - `_id` string, required — The ID of the job
        - `sellerId` string, required — The ID of the seller of the job
        - `title` string — The title of the job
        - `type` 'transformJob', required
        - `status` 'SCHEDULED' | 'RUNNING' | 'FAILED' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' — The status of the job.
        - `runAfter` string, date-time — An ISO timestamp indicating after which time the job should be run.
        - `startedAt` string, date-time — An ISO timestamp indicating when the job started
        - `finishedAt` string, date-time — An ISO timestamp indicating when the job finished
        - `payload` union
          - object
            - `resource` 'ticketRangeInvalidation', required
            - `csv` string — An URL to download the CSV data.
            - `json` string — An URL to download the JSON data.
            - `params` object
              - …
          - object
            - `csv` string — An URL to download the CSV data.
            - `json` string — An URL to download the JSON data.
      - object
        - `_id` string, required — The ID of the job
        - `sellerId` string, required — The ID of the seller of the job
        - `title` string — The title of the job
        - `status` 'SCHEDULED' | 'RUNNING' | 'FAILED' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' — The status of the job.
        - `runAfter` string, date-time — An ISO timestamp indicating after which time the job should be run.
        - `startedAt` string, date-time — An ISO timestamp indicating when the job started
        - `finishedAt` string, date-time — An ISO timestamp indicating when the job finished
        - `type` 'import' | 'export' | 'delete' | 'scheduledJob', required — The type of job.
  - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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