YOUHODLERBusiness API
Get access
View as Markdown

getGet conversion

Required capabilityconversions.read

Returns the current conversion operation snapshot. Preview economics are non-binding display data; settled execution may use recomputed fees and rate before ledger posting.

Request

Request URL

GET
GET /conversions/{conversion_id}

Responses

Response

application/json
{
  "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"
}

Operation succeeded.

Related endpoints