Console operations / API reference

Read Console RFQs

Request and response reference for GET /v1/console/operations/rfqs.

GET/v1/console/operations/rfqs

Authentication: Console sessionPermission: rfq.read

Use the base URL and access configuration provided to your institution. Examples are request templates, not transaction results. Field tables focus on client fields; preserve additional metadata returned by the configured service.

Request

This interface uses an approved institutional session, not a financial API key. Session writes also need Origin and CSRF protection. Use the JavaScript sample within an authorized browser integration.

Request templatecURL

curl -X GET "$OSAI_CONSOLE_BASE_URL/v1/console/operations/rfqs" \
  -H "Origin: $OSAI_APP_ORIGIN" \
  --cookie "$OSAI_SESSION_COOKIE_FILE"

Parameters

No endpoint-specific path or query parameters are defined. Authentication and access policy still apply.

Request body

This operation does not define a JSON request body.

Responses

Inspect HTTP status before parsing a body. These tables describe client response fields rather than invented successful transaction payloads.

200 · Institution-scoped owner evidence; no external finality inferred

Field	Type	Description & constraints
`institution_id`Required in parent object	`string`	Defined by the resource contract.
`observed_at`Required in parent object	`string`	Defined by the resource contract.
`source`Required in parent object	`string`	Defined by the resource contract.
`items`Required in parent object	`array`	Defined by the resource contract.
`items[].request_id`Required in parent object	`string`	Defined by the resource contract.
`items[].proposal_id`Required in parent object	`string`	Defined by the resource contract.
`items[].acceptance_status`Required in parent object	`string`	Defined by the resource contract.
`items[].beneficiary_id`Required in parent object	`string`	Defined by the resource contract.
`items[].trade_id`Required in parent object	`string`	Defined by the resource contract.
`items[].updated_at`Required in parent object	`string`	Defined by the resource contract.
`items[].terms`Required in parent object	`object`	Defined by the resource contract.
`items[].terms.quote_id`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.status`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.base_amount_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.base_currency`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.quote_currency`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.destination_rail`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.amount_out_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.rate_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.fee_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.expires_at`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.correlation_id`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.trade_id`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.quote_mode`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.source_principal_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.total_debit_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.destination_target_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.destination_surplus_minor`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.rate_direction`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.rate_scale`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.fee_schedule_id`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.fee_schedule_version`Required in parent object	`string`	Defined by the resource contract.
`items[].terms.source_minor_exponent`Required in parent object	`integer`	Defined by the resource contract.
`items[].terms.destination_minor_exponent`Required in parent object	`integer`	Defined by the resource contract.
`items[].terms.total_cost_minor`Required in parent object	`string`	Defined by the resource contract.

400 · Invalid query

No client body fields are defined for this response.

401 · Session required

No client body fields are defined for this response.

403 · Permission denied

No client body fields are defined for this response.

503 · Owner unavailable; no scenario fallback

No client body fields are defined for this response.

Retries & recovery

Keep the original request identifiers and any required idempotency key. A timeout does not establish failure. Read the original resource or command before another financial write; use expected versions for concurrent changes.

Error handling →Idempotency →