---
title: "Get a list of jobs"
method: POST
path: "/v1/jobs/all"
---

# Get a list of jobs

`POST /v1/jobs/all`

## Query parameters

- `projectId` string, required

## Request body

- JobsRequest
  - `sort` SortOptions
    - `field` 'createdAt' | 'model' | 'totalCost' | 'usageTime' | 'status'
    - `direction` 'asc' | 'desc'
  - `take` integer
  - `skip` integer
  - `search` string
  - `status` 'PENDING' | 'COMPLETED' | 'FAILED'
  - `type` 'TRANSCRIPTION' | 'TRANSLATION' | 'TTS' | 'AI_CONTENT'

## Response `200`

Successful response

- JobsResponse
  - `success` boolean
  - `message` string
  - `data` JobsData
    - `jobs` Job[]
      - `id` string, required
      - `title` string, required
      - `type` 'AI_CONTENT' | 'TRANSCRIPTION' | 'TTS' | 'TRANSLATION', required
      - `url` string, uri, required
      - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required
      - `cost` number, required
      - `systemModelKey` string, required
      - `relevantJobId` string, required
      - `attributes` object, required
        - `apiKey` string, required
        - `mediaUrl` string, uri
        - `model` string
        - `agentName` string
        - `duration` number
        - `voice` string
        - `aiContentParts` unknown[]
          - unknown
        - `sourceJob` string
      - `apiKey` string
      - `createdBy` string
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `total` integer
    - `filtered` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)