---
title: "Get job status and metadata"
method: GET
path: "/v4/query/jobs/{job_id}"
tags: ["v4", "Query Jobs"]
---

# Get job status and metadata

`GET /v4/query/jobs/{job_id}`

## Path parameters

- `job_id` string, required

## Response `200`

Success

- SuccessResponseDuckDBJobResponse
  - `success` true, required — Flag for it request was successful
  - `data` DuckDBJobResponse, required
    - `jobId` string, required — Unique job identifier (e.g., 'duckdb-job-abc123')
    - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'unknown', required — Status of an async DuckDB K8s job.
    - `teamId` union — Team that submitted the job
      - string, uuid
      - string
    - `userId` union — User that submitted the job
      - string, uuid
      - string
    - `integrationId` union — Integration used
      - string, uuid
      - string
    - `blockId` union — Associated block ID
      - string, uuid
      - string
    - `queryType` 'json' | 'arrow' | 'exec' | 'batch'
    - `cpu` string, nullable — CPU resources requested
    - `memory` string, nullable — Memory requested
    - `timeoutSeconds` integer, nullable — Job timeout
    - `createdAt` string, date-time, nullable — Job submission time
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `404` — Resource Not Found
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)