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.

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

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

{
  "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

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.

For real-time updates, subscribe to operation.created, operation.completed, operation.failed, and operation.cancelled — see Webhook events.

Next steps

Operation lifecycle

Statuses and webhook mapping.

Users and CIP

User list, block/unblock, CIP readiness.

API overview

Envelopes, auth, pagination conventions.

Getting Started

Request API

Concepts

Integration

Flows

Webhooks

Operations

Overview

Status filter values

List operations

Query parameters

Response shape

Get operation detail

Next steps

Operation lifecycle

Users and CIP

API overview

​Overview

​Status filter values

​List operations

​Query parameters

​Response shape

​Get operation detail

​Next steps

Operation lifecycle

Users and CIP

API overview

Overview

Status filter values

List operations

Query parameters

Response shape

Get operation detail

Next steps