# List operations

`GET https://api.instacloud.com/projects/{projectId}/operations`

**Token scope:** `account` · `org` · `project` — read-only tokens allowed.

Recent database provider operations. Control-plane — does NOT wake the database.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `branch` | query | `string` | no | branch name (default branch if omitted) |
| `group` | query | `string` | no | postgres service name (default: the sole postgres service) |
| `limit` | query | `integer` | no | max operations (provider default if omitted) |
| `cursor` | query | `string` | no | pagination cursor from a previous page |
| `projectId` | path | `string` | yes |  |

## Response 200

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `operations` | `object[]` | no |  |
| `operations.id` | `string` | no |  |
| `operations.action` | `string` | no |  |
| `operations.status` | `string` | no |  |
| `operations.endpointId` | `string` | no |  |
| `operations.durationMs` | `number` | no |  |
| `operations.createdAt` | `string` | no |  |
| `operations.updatedAt` | `string` | no |  |
| `nextCursor` | `string` | no |  |

## Response 400

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 403

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 404

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 409

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 502

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |