---
title: "Get Scim Sync Run"
method: GET
path: "/v1/admin/scim/sync/{run_id}"
tags: ["beta.admin.scim"]
---

# Get Scim Sync Run

`GET /v1/admin/scim/sync/{run_id}`

Retrieve an on-demand SCIM synchronization run for the Organization.

Returns the run's lifecycle status along with the preview or result summary
once the synchronization plan has been built.

## Path parameters

- `run_id` string, uuid, required — Identifier of the SCIM synchronization run.

## Response `200`

OK

- AdminScimSyncRunOUT
  - `run_id` string, uuid, required — Unique identifier of the SCIM synchronization run.
  - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'SKIPPED' | 'FAILED', required
  - `dry_run` boolean, required — Whether the run only previewed changes.
  - `sync_config` AdminScimSyncConfig, required
    - `delete_missing_groups` boolean — Delete Organization groups that are absent from the SCIM provider.
    - `deprovision_users` boolean — Remove Organization users that are inactive or absent from the SCIM provider.
    - `sync_users` boolean, required — Add users found in the SCIM provider to the Organization.
    - `sync_groups` boolean, required — Synchronize group metadata from the SCIM provider.
    - `sync_memberships` boolean, required — Synchronize additions and removals of users in SCIM groups.
  - `created_at` string, date-time, required — Time at which the synchronization run was created.
  - `started_at` string, date-time, nullable, required — Time at which processing started, if it has started.
  - `finished_at` string, date-time, nullable, required — Time at which processing finished, if it has finished.
  - `summary` ScimSyncSummaryOut, required
    - `users` ScimSyncUsersSummaryOut, required
      - `provision` ScimSyncUserActionOut[], required
        - `user` ScimSyncUserRefOut, required
          - `uuid` string, required
          - `userName` string, required
      - `deprovision` ScimSyncUserActionOut[], required
        - `user` ScimSyncUserRefOut, required
          - `uuid` string, required
          - `userName` string, required
    - `groups` ScimSyncGroupsSummaryOut, required
      - `create` ScimSyncGroupActionOut[], required
        - `group` ScimSyncGroupRefOut, required
          - `uuid` string, required
          - `groupName` string, required
      - `update` ScimSyncGroupUpdateActionOut[], required
        - `group` ScimSyncGroupRefOut, required
          - `uuid` string, required
          - `groupName` string, required
        - `previous_groupName` string, required
      - `delete` ScimSyncGroupActionOut[], required
        - `group` ScimSyncGroupRefOut, required
          - `uuid` string, required
          - `groupName` string, required
    - `memberships` ScimSyncMembershipActionOut[], required
      - `group` ScimSyncGroupRefOut, required
        - `uuid` string, required
        - `groupName` string, required
      - `users_added` ScimSyncUserRefOut[], required
        - `uuid` string, required
        - `userName` string, required
      - `users_removed` ScimSyncUserRefOut[], required
        - `uuid` string, required
        - `userName` string, required
  - `error_message` string, nullable, required — Failure detail when the synchronization run could not complete.

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)