---
title: "Ingest job details"
method: GET
path: "/ingest/jobs/{job-id}"
tags: ["Ingest"]
---

# Ingest job details

`GET /ingest/jobs/{job-id}`

## Request

- Base URL: `https://app.amperity.com/api`
- URL: `https://app.amperity.com/api/ingest/jobs/{job-id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/amperity/apis/amperity-api/docs/ingest/jobs/:job-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Return details for a specific ingest job, including a summary of the records, files, and feeds that were ingested.

## Path parameters

- `job-id` string, required

## Query parameters

- `api_version` string

## Headers

- `Amperity-Tenant` string, required
- `Api-Version` string, required

## Response `200`

A summary of records, files, and feeds ingested in this job

- IngestJobDetails: Ingest job details
  - `id` string, required: The Amperity internal identifier for the injest job.
  - `tables` IngestFeedDetails[], required: A summary of table details from this ingest job.
    - `ended_at` string, date-time, required: The date and time at which a job ended.
    - `errors` integer, required: The number of rows with an ingest error.
    - `feed_id` string, required: The unique ID of this feed.
    - `files` IngestFileDetails[], required: Array of IngestFileDetails
      - `errors` integer, required: The number of rows with an ingest error. For example, when Amperity cannot match a field value to the expected data type.
      - `file_id` string, required: The identifier for the file
      - `name` string: The human readable identifier for the file
      - `read` integer, required: The total count of records processed in this file
    - `inserted` integer, required: The total count of records added to this feed.
    - `job_id` string, required: The ingest job identifier.
    - `read` integer, required: The number of rows ingested into this feed.
    - `rejected` integer, required: The number of duplicate rows that were not ingested.
    - `started_at` string, date-time, required: The date and time at which a job started.
    - `state` string, required: The current state of the job.
    - `table_name` string, required: The name of the updated table.
    - `updated` integer, required: The total count of rows updated for this feed during the job.
  - `workflow_id` string, required: The Amperity internal identifier for the workflow that ran this job.

## Other responses

- `400`: Bad Request
- `401`: Authentication Required
- `403`: Not Authorized
- `404`: Not Found
- `405`: Method Not Allowed
- `500`: Internal Error

---

[API](https://skmtc.dev/amperity/apis/amperity-api.md) - [All operations](https://skmtc.dev/amperity/apis/amperity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/amperity/apis/amperity-api/revisions/97ccd051d9dc?raw)