# operationRecords

Query

Paginate the per-item records of an operation, newest first. Optionally filter by record status.

Available to agents as MCP tool `getOperationRecords` — see [Read tools](/api/v2/docs/mcp/read-tools#get-operation-records).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `after` | `String` | No | `null` | Cursor for fetching the next page of results. |
| `filter` | [`OperationRecordFilterInput`](/api/v2/docs/types/operation-record-filter-input) | No | `{}` | Filter criteria for operation records. |
| `first` | `Int` | No | `100` | Number of records to return (page size, default 100, max 1000 — one page covers any operation created via refetchEngagementBulk). |
| `operationId` | `ID!` | Yes | — | ID of the operation whose records to page through. |

## Returns

A paginated connection of [`OperationRecord`](/api/v2/docs/types/operation-record) nodes. See [Pagination](/api/v2/docs/types/pagination) for the connection shape.

## Examples

### Page an operation's records

Paginate the per-item records of an operation, filtered to successful items.

```graphql
query OperationRecordsDefault($operationId: ID!, $first: Int, $after: String) {
  operationRecords(operationId: $operationId, filter: { status: SUCCEEDED }, first: $first, after: $after) {
    totalCount
    edges {
      node {
        itemId
        status
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
```

Variables:

```json
{
  "operationId": "aeb032f4-179f-549f-b83c-3db2c5b58a2d",
  "first": 20
}
```

Response — HTTP 200:

```json
{
  "data": {
    "operationRecords": {
      "totalCount": 1,
      "edges": [
        {
          "node": {
            "itemId": "3467594a-79c1-5fa4-8490-8a31646ff716",
            "status": "SUCCEEDED"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": "Z2lkOi8vYXJjaGl2ZS9PcGVyYXRpb25SZWNvcmQvMjAyNC0xMi0zMVQyMjowMDowMC4wMDAwMDBafDY1YTAxMGQ2LTc3MzAtNTIwNC1iNTVlLTYzNDM3MTNkNDRjOA=="
      }
    }
  }
}
```