---
title: "Get auto-assign status"
method: GET
path: "/scheduler/v2/schedulers/{schedulerId}/shifts/auto-assign/{autoAssignRequestId}"
tags: ["Schedule:v2:Schedulers:Schedule:Shift Auto Assign (V2):Shift Auto Assign"]
---

# Get auto-assign status

`GET /scheduler/v2/schedulers/{schedulerId}/shifts/auto-assign/{autoAssignRequestId}`

## Request

- Base URL: `https://api.connecteam.com`
- URL: `https://api.connecteam.com/scheduler/v2/schedulers/{schedulerId}/shifts/auto-assign/{autoAssignRequestId}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - OAuth 2
    - Client credentials
    - Token URL: `/oauth/v1/token` scopes: `schedule.read`

Retrieve the status of an auto-assign request using its unique request ID. The response categorizes the results into 'scheduled shifts' for successfully assigned shifts and 'unscheduled shifts' for those where auto-assignment was not successful.

## Path parameters

- `autoAssignRequestId` integer, required: The unique identifier of the auto assign request
- `schedulerId` integer, required: The unique identifier of the schedule

## Response `200`

Successful Response

- APIResponseV2AutoAssignStatusResponse
  - `requestId` string
  - `data` AutoAssignStatusResponse, required
    - `autoAssignRequestId` string, required: The unique identifier of the auto assign request
    - `status` string, nullable: The status of the request
    - `assignedShiftIds` string[], nullable: List of shift IDs that were successfully assigned
    - `unassignedShiftIds` string[], nullable: List of shift IDs that were not successfully assigned

## Other responses

- `422`: Validation Error

---

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