---
title: "Retrieve the Status of Multiple Offline User Upload Jobs"
method: GET
path: "/jobs"
---

# Retrieve the Status of Multiple Offline User Upload Jobs

`GET /jobs`

Retrieve the status of multiple offline user upload jobs by group ID or date range.
Use exactly one of the following query parameter combinations per request:

- `group_id`: Returns all jobs associated with the specified group ID.
- `date_from` and `date_to`: Returns all jobs created within the specified date range.

## Query parameters

- `group_id` string
- `date_from` string
- `date_to` string

## Headers

- `appid` string, required
- `authorization` string, required

## Response `200`

Success

- object
  - `matched_jobs` object — A summary of upload job results by job count.
    - `total` integer — The total number of matched jobs.
    - `queued` integer — The number of jobs currently queued.
    - `finished` integer — The number of jobs where at least one user profile uploaded successfully. Partially completed jobs are counted as finished.
    - `in_progress` integer — The number of jobs currently in progress.
    - `fatal_error` integer — The number of jobs where all user profiles failed to upload due to server errors.
    - `invalid_schema` integer — The number of jobs where no valid user profiles were found in the data file.
  - `received_lines` integer — The total number of user profile lines across all matched jobs.
  - `aggregation` object — A summary of upload results by user profile count.
    - `created` integer — The number of unmatched offline users created in the common database.
    - `updated` integer — The number of user profiles merged. This value may exceed `received_lines` because a single offline profile can be merged with multiple platform profiles.
    - `invalid` integer — The number of user profiles that failed validation, for example due to incorrect data format or missing identifiers.
    - `error` integer — The number of user profiles that couldn't be uploaded due to server errors.
  - `jobs_with_invalid_records` string[] — A list of job IDs that contain invalid or errored records. Use these IDs with [Retrieve the Status of an Offline User Upload Job](https://docs.aiqua.appier.com/reference/bulk-upload-offline-api-retrieve-the-status-of-an-offline-user-upload-job) and the `errors=1` parameter to retrieve error details.
  - `group_id` string — The group ID used in the request. Returned when querying by group ID.
  - `date_from` string — The start of the date range used in the request. Returned when querying by date range.
  - `date_to` string — The end of the date range used in the request. Returned when querying by date range.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/appier/apis/retrieve-a-user.md) · [All operations](https://skmtc.net/appier/apis/retrieve-a-user/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appier/retrieve-a-user/versions/2885365fa9c9/schema)