> ## Documentation Index
> Fetch the complete documentation index at: https://docs.techforgeinnovate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Job

> Fetch a queued or completed job that belongs to the authenticated account.

# Get Job

Returns the raw job record for a job that belongs to the authenticated account.

## Path parameters

<ParamField path="id" type="string" required>
  Job UUID.
</ParamField>

## Example request

```bash theme={null}
curl "https://api.techforgeinnovate.com/jobs/15a6331b-3837-4ae8-8fa7-d3ead3388d77" \
  -H "x-api-key: $TFI_API_KEY"
```

## Successful response

The controller returns the persisted Prisma job row directly.

<ResponseField name="uuid" type="string" required>
  Job UUID.
</ResponseField>

<ResponseField name="job_status" type="string">
  Job status such as `QUEUED`, `STARTED`, `IN_PROGRESS`, `FAILED`, or `SUCCESS`.
</ResponseField>

<ResponseField name="input" type="object">
  Original job payload submitted to `POST /jobs/v2`.
</ResponseField>

<ResponseField name="output" type="object">
  Worker-produced output payload, if present.
</ResponseField>

Example response:

```json theme={null}
{
  "uuid": "15a6331b-3837-4ae8-8fa7-d3ead3388d77",
  "user_id": "c95a2ab1-7c10-4a03-9d25-55f905d2b6f0",
  "template_id": "468ea7a0-66e1-4357-a760-236e54167f3e",
  "input": {
    "template_id": "468ea7a0-66e1-4357-a760-236e54167f3e",
    "job_type": "ai_talking_video",
    "version": 2,
    "values": {
      "headline": "Launch in minutes"
    }
  },
  "output": {
    "output": "ai-talking-videos/468ea7a0-66e1-4357-a760-236e54167f3e/outputs/15a6331b-3837-4ae8-8fa7-d3ead3388d77.mp4"
  },
  "values": {
    "headline": "Launch in minutes"
  },
  "job_status": "SUCCESS",
  "job_type": "ai_talking_video",
  "credit_used": "12.5",
  "created_at": "2026-04-16T12:03:02.000Z",
  "updated_at": "2026-04-16T12:05:18.000Z"
}
```

## Not found response

If the job does not exist or does not belong to the API-key owner, the controller returns:

```json theme={null}
{
  "message": "Job not found"
}
```

## Status codes

* `200 OK` for both found and not-found payloads under the current implementation
* `401 Unauthorized` when the key is missing or invalid