---
title: "Get Job Status"
method: GET
path: "/ingestion/status/{job_id}"
tags: ["Ingestion Pipeline"]
---

# Get Job Status

`GET /ingestion/status/{job_id}`

## Request

- Base URL: `https://api.getmetacognition.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getmetacognition.com/ingestion/status/{job_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/ingestion/status/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `job_id` string, required

## Response `200`

Successful Response

- JobStatusResponse: Job status response.
  - `job_id` string, required: Job identifier
  - `job_type` string, required: Job type
  - `status` string, required: Job status
  - `progress` JobProgress, required: Job progress information.
    - `current_step` string, required: Current step
    - `progress_percent` integer, required: Progress percentage
    - `steps_completed` string[]: Completed steps
    - `steps_remaining` string[]: Remaining steps
  - `scope` Scope, required: Multi-tenant scope.
    - `org_id` string, required: Organization ID
    - `user_id` string, nullable: User ID
    - `session_id` string, nullable: Session ID
  - `created_at` string, date-time, required: Creation time
  - `updated_at` string, date-time, required: Last update time
  - `completed_at` string, date-time, nullable: Completion time
  - `google_drive_file_id` string, nullable: Google Drive file ID
  - `unstructured_job_id` string, nullable: Unstructured job ID
  - `s3_url` string, nullable: S3 URL
  - `helix_response` object, nullable: HelixDB response
  - `error_message` string, nullable: Error message
  - `partial` boolean: True when the engine stored the ingest but dropped some items (HTTP 206); see partial_errors
  - `partial_errors` string[]: Per-item errors for a partial ingest

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/metacognition/apis/tex-api.md) - [All operations](https://skmtc.dev/metacognition/apis/tex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacognition/apis/tex-api/revisions/3bef47e50f2e?raw)