---
title: "List converge action"
method: GET
path: "/v2/converge"
tags: ["drift_Converge"]
---

# List converge action

`GET /v2/converge`

Retrieves a paginated list of Converge actions issued in the tenant.

Each record reflects a single device's Converge request, including which blueprint and version it targeted and its current aggregate status. Filter by device_ids to scope the list to specific devices.

**About List Converge Actions**

Converge is the mechanism that assigns a device to a blueprint and blueprint version and brings it into alignment with that configuration, covering apps, files, restrictions, and platform settings. Each Converge action moves through QUEUED, PROCESSING, IN_PROGRESS, and a terminal SUCCESS or FAILURE state as Esper applies the blueprint. This endpoint is the tenant-wide view of that activity, separate from the alpha Operations API, which handles Converge issued at fleet scale through POST /v0/operations/.

**Key Fields / Query Parameters**

device_ids — filters results to one or more device IDs, accepts comma-separated values

**Common Use Cases**

Reviewing the Converge history for a specific device

Auditing recent Converge activity across the tenant

**Best Practices**

Filter by device_ids when troubleshooting a specific device rather than paging through the full tenant-wide list

For large-scale Converge issued through the Operations API, use GET /v0/operations/ and its device-level endpoints instead of this list

**Workflow**

Call this endpoint with device_ids to scope to the devices you're investigating

Identify the converge id for the action you need

Call GET /v2/converge/{id} for full detail, or /v2/converge/{id}/commands to see the underlying commands it fired

## Query parameters

- `device_ids` string
- `limit` number
- `offset` number

## Response `200`

Converge action list for the Tenant

- object
  - `content` object
    - `count` integer
    - `previous` string
    - `next` string
    - `results` DriftConverge[]
      - `id` string, uuid — Unique converge identifier
      - `device_id` string, uuid — ID of the device
      - `converge_with_provision_option` boolean
      - `blueprint_info` DriftBlueprintsInfo
        - `blueprint_id` string, uuid — Unique blueprint ID
        - `blueprint_version_id` string, uuid — Version ID of blueprint
      - `schedule_type` 'IMMEDIATE' | 'WINDOW' — Following Schedule types are supported ``` * IMMEDIATE: Schedule the command to execcute Immediately * WINDOW: Schedule the command to execute within the given window ```
      - `schedule_args` object
      - `status` 'QUEUED' | 'PROCESSING' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILURE' — Current aggregrated status of the converge action
      - `reason` string — details briefing the reason for current converge status
      - `created_by` string — user id of the user
      - `created_at` string, date-time — Creation timestamp of converge
      - `updated_at` string, date-time — Updation timestamp of converge

## Other responses

- `401` — Authorization information is missing or invalid.
- `500` — Internal server error

---

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