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

# Ingest job details list

`GET /ingest/jobs`

## Request

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

Return a list of ingest jobs from your tenant that occurred within the previous 7 days.

## Query parameters

- `api_version` string
- `with_total` boolean
- `created_from` string, date-time, required
- `created_to` string, date-time, required

## Headers

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

## Response `200`

A summary of records, files, and feeds ingested in the set of jobs from the given datetime range (not to exceed 7 days)

- IngestJobDetailsListEnvelope: Wrapper containing a list of ingest details.
  - `data` IngestJobDetails[], required: List of ingest 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.
  - `next_token` string: CURRENTLY UNUSED BUT RESERVED FOR FUTURE USE: The cursor value to use in a subsequent request to return the next page of results.
  - `total` integer: The total count of all results. This property is only returned when `with_total` is set to `true` in a request.

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