# List operations

`GET https://api.cademi.com.br/api/v3/operations`

Operation ID: `operations.list` · API v3

Lists the asynchronous operations of the current account, using cursor-based pagination.

The collection can be filtered by status and type and sorted by creation date.

Required permissions: `operations.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer | no |  |
| `cursor` | query | string | no |  |
| `sort` | query | string, one of `created_at`, `-created_at` | no |  |
| `status` | query | string, one of `queued`, `running`, `succeeded`, `partially_succeeded`, `failed`, `canceled` | no |  |
| `type` | query | string, one of `credential.revoke`, `sandbox.reset`, `webhook.replay`, `product.publish_all`, `product.copy`, `module.publish_all`, `module.copy`, `email.send_test`, `lesson.copy`, `access.apply_all`, `sandbox.run_scenario`, `configuration.apply`, `delivery.apply_tags`, `sales_event.reprocess`, `diamond.reprocess_membership`, `import.analyze`, `import.process`, `export.generate` | no |  |

## Responses

### 200

Returns the collection of operations.

Body: `data`: array of Operation.

Fields of Operation:

| Field | Type | Required | Description |
|---|---|---|---|
| `attempt` | object or null | yes |  |
| `cancellation_requested` | boolean | yes |  |
| `created_at` | string (date-time) | yes |  |
| `error` | object or null | yes |  |
| `expires_at` | string (date-time) | yes |  |
| `finished_at` | string or null (date-time) | yes |  |
| `id` | string | yes | Public ID, with the op_ prefix. |
| `items_url` | string | yes |  |
| `object` | string, one of `operation` | yes |  |
| `progress` | object | yes |  |
| `result_url` | string or null | yes |  |
| `started_at` | string or null (date-time) | yes |  |
| `status` | string, one of `queued`, `running`, `succeeded`, `partially_succeeded`, `failed`, `canceled` | yes |  |
| `type` | string | yes | Type of the operation, from a fixed set of values. |

### 400

The cursor is invalid or the request contains an unsupported query parameter.

Body: Error.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json