---
title: "GET /invites/{code}/target-users/job-status"
method: GET
path: "/invites/{code}/target-users/job-status"
---

# GET /invites/{code}/target-users/job-status

`GET /invites/{code}/target-users/job-status`

Get the target users job status for an invite.

## Response `200`

200 response for get_invite_target_users_job_status

- TargetUsersJobStatusResponse
  - `status` union, required
    - 0 — The default value.
    - 1 — The job is still being processed.
    - 2 — The job has been completed successfully.
    - 3 — The job has failed, see error_message field for more details.
  - `total_users` integer, required
  - `processed_users` integer, required
  - `created_at` string, date-time, nullable, required — The timestamp when the job was created.
  - `completed_at` string, date-time, nullable, required — The timestamp when the job was successfully completed.
  - `error_message` string, nullable, required — The error message if the job failed.

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

- **2026-02-04** `e200830e509a` — 3 info
  - the response property `completed_at` became required for the status `200`
  - the response property `created_at` became required for the status `200`
  - the response property `error_message` became required for the status `200`
- **2026-01-14** `95cbb52dd086` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/invites/:code/target-users/job-status/get.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)