> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leapfinancial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Operations

> List and retrieve money transfer operations with GET /partner/operations

## Overview

After users complete transfers in a widget, you can query operations for reporting, support, and reconciliation. For status meanings and the webhooks that fire as an operation progresses, see [Operation lifecycle](/raas-widgets/ops/operation-lifecycle).

| Method | Path                               | Purpose                       |
| ------ | ---------------------------------- | ----------------------------- |
| `GET`  | `/partner/operations`              | Paginated list with filters   |
| `GET`  | `/partner/operations/:operationId` | Full detail for one operation |

Auth: `X-API-Key` (`raas_sandbox_*` / `raas_live_*`).

### Status filter values

| `status`     | Meaning                                |
| ------------ | -------------------------------------- |
| `created`    | Operation initiated                    |
| `processing` | Funds in transit / awaiting settlement |
| `completed`  | Transfer successful                    |
| `failed`     | Transfer failed                        |
| `cancelled`  | Operation cancelled                    |

## List operations

```bash theme={null}
curl "https://raas-widgets-backend-sandbox.up.railway.app/partner/operations?page=1&limit=20" \
  -H "X-API-Key: raas_sandbox_your_api_key_here"
```

### Query parameters

| Param         | Description                                                     |
| ------------- | --------------------------------------------------------------- |
| `page`        | Page number (default `1`)                                       |
| `limit`       | Page size (default `20`)                                        |
| `referenceId` | Filter by your end-user id                                      |
| `userId`      | Filter by platform user id                                      |
| `linkId`      | Filter by magic link                                            |
| `status`      | Filter by operation status                                      |
| Date range    | Supported when present in OpenAPI (`from` / `to` style filters) |

### Response shape

```json theme={null}
{
  "success": true,
  "data": {
    "items": [
      {
        "operationId": "op_acme_abc123",
        "referenceId": "user_12345",
        "linkId": "link_acme_a1b2c3d4e5f6",
        "status": "completed",
        "amount": {
          "send": 100,
          "receive": 1850.5,
          "rate": 18.505,
          "fee": 3.99
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 42,
      "totalPages": 3
    }
  }
}
```

## Get operation detail

```bash theme={null}
curl https://raas-widgets-backend-sandbox.up.railway.app/partner/operations/op_acme_abc123 \
  -H "X-API-Key: raas_sandbox_your_api_key_here"
```

Detail responses include funding/payout method summaries, amount breakdown, status timeline, and failure reason when applicable.

<Tip>
  For real-time updates, subscribe to `operation.created`, `operation.completed`, `operation.failed`, and `operation.cancelled` — see [Webhook events](/raas-widgets/webhooks/events).
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Operation lifecycle" icon="diagram-project" href="/raas-widgets/ops/operation-lifecycle">
    Statuses and webhook mapping.
  </Card>

  <Card title="Users and CIP" icon="id-card" href="/raas-widgets/ops/users-and-cip">
    User list, block/unblock, CIP readiness.
  </Card>

  <Card title="API overview" icon="book" href="/raas-widgets/api-reference/introduction">
    Envelopes, auth, pagination conventions.
  </Card>
</CardGroup>