---
title: "Retrieve job details"
method: GET
path: "/v1/jobs"
---

# Retrieve job details

`GET /v1/jobs`

## Query parameters

- `jobId` string, required
- `search` string
- `speaker` string

## Response `200`

Successful retrieval of job details

- JobResponse
  - `message` string
  - `previewUrl` string, uri
  - `data` object
    - `id` string, required
    - `title` string, required
    - `model` string, required
    - `type` string, required
    - `processingType` string, required
    - `webhookUrl` string, nullable
    - `totalCost` number, required
    - `usageTime` string, required
    - `fromLng` string, nullable
    - `toLng` string, nullable
    - `mediaUrl` string, uri
    - `jobResponse` object, nullable
    - `fromScript` string, nullable
    - `toScript` string, nullable
    - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required
    - `relevantJobId` string, nullable
    - `agentDetails` string, nullable
    - `apiKeyId` string, required
    - `billingId` string, required
    - `systemModelKey` string, required
    - `voiceAgentId` string, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Job not found

---

[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)