List operations

GET 
/v1/operations

List the operations visible to the calling bank: those your bank initiated and those in which your bank is the counterparty (for example the receiving bank of an interbank transfer).

An operation is the platform's record of one workflow mutation (a transfer, an account registration, a limit change, a webhook change, a cancellation, and so on). Every mutation returns 202 Accepted with the operation's id; use this endpoint to find operations, and GET /v1/operations/{operation_id} to follow a single one.

Required scope: connector:operations:list.

Ordering and paging. Results are ordered oldest first (by created_at, then id). Follow links.next to page forward until it is absent.

Filtering. Only filter[state] is supported. Other filter[...] parameters are ignored.

The list returns each operation's summary fields; ledger_refs and bank_id are only returned by GET /v1/operations/{operation_id}.

Request

Responses

200

One page of operations, oldest first. data is an empty array when nothing matches.

400

The request is malformed: invalid JSON syntax, an invalid path or query parameter, a missing required header such as Idempotency-Key, or a single field that fails its own format rule. Fix the request before retrying; retrying it unchanged fails again.

401

The bearer token is missing, malformed, expired, signed by an unknown key, or was not issued by the platform IAM for the Lyriq Connector. Obtain a new token and retry. See the Authentication section.

403

The token is valid but may not perform this request: it lacks the required scope, has no bank membership, needs an x-dan-bank-id header to choose between several memberships, names a bank in x-dan-bank-id it has no membership for, or the caller's bank is suspended or terminated. A new token with the same configuration fails the same way. See the Authentication section.

503

The request could not be served right now. Either the network is not fully operational (OUTBOUND_HALTED or READ_ONLY: mutations are refused while read endpoints keep working; OPERATIONAL_STATE_UNKNOWN: the state could not be determined), or a platform dependency is temporarily unavailable. No Retry-After header is sent; retry later with backoff. When retrying a mutation, reuse the same Idempotency-Key and body.