YOUHODLERBusiness API
Get access
View as Markdown

getList conversions

Required capabilityconversions.read

Lists conversion operation snapshots. Preview responses are informational only; operation execution may recompute fees and rate before ledger posting, so reads must not be treated as a bound preview replay.

Request

Request URL

GET
GET /conversions

Responses

Response

application/json
{
  "items": [
    {
      "account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "applied_rate": null,
      "approval_ref": null,
      "conversion_execution_id": null,
      "created_at": "2026-05-01T10:00:00Z",
      "failure_detail": null,
      "failure_reason": null,
      "family": "conversion",
      "fee_summary": {
        "components": [
          {
            "amount": {
              "currency": "USDC",
              "value": "1.00"
            },
            "kind": "network_fee"
          }
        ],
        "total": {
          "currency": "USDC",
          "value": "1.00"
        }
      },
      "fee_transaction_ids": null,
      "fill_rate": null,
      "id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "ledger_posted_target_amount": null,
      "leg_attempt_id": null,
      "posted_at": null,
      "principal_amount": {
        "currency": "USDC",
        "value": "250.00"
      },
      "principal_transaction_id": null,
      "settled_at": null,
      "source_gross_amount": null,
      "source_principal_amount": null,
      "status": "executing",
      "subject_attribution": {
        "actor": null,
        "approved_by": null,
        "authenticated_principal": {
          "id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
          "kind": "user",
          "tenant_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
        },
        "enterprise_binding": {
          "tenant_type": "enterprise",
          "topology_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
        },
        "federation": null,
        "identity_source": "platform-managed",
        "initiated_by": null,
        "subject": {
          "id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
          "kind": "user",
          "tenant_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
        }
      },
      "target_amount": null,
      "updated_at": "2026-05-01T10:00:00Z"
    }
  ],
  "next_page_token": null
}

Operation succeeded.

Related endpoints