Retrieve a conversion

curl

curl https://api.orrerie.com/v1/conversions/cv_ban2ezvpwf4j4d09h4htv42j \
  -H "Authorization: Bearer $ORRERIE_SECRET_KEY"

JavaScript

const response = await fetch("https://api.orrerie.com/v1/conversions/cv_ban2ezvpwf4j4d09h4htv42j", {
  headers: {
    Authorization: `Bearer ${process.env.ORRERIE_SECRET_KEY}`,
  },
});
const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result);

Python

import os
import requests

response = requests.get(
    "https://api.orrerie.com/v1/conversions/cv_ban2ezvpwf4j4d09h4htv42j",
    headers={"Authorization": f"Bearer {os.environ['ORRERIE_SECRET_KEY']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")
print(result)

PHP

<?php
$request = curl_init('https://api.orrerie.com/v1/conversions/cv_ban2ezvpwf4j4d09h4htv42j');
curl_setopt_array($request, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ORRERIE_SECRET_KEY'),
    ],
]);
$body = curl_exec($request);
if ($body === false) {
    throw new RuntimeException(curl_error($request));
}
$result = json_decode($body, true);
if (curl_getinfo($request, CURLINFO_HTTP_CODE) >= 400) {
    throw new RuntimeException($result['error']['code'] . ': ' . $result['error']['message']);
}
print_r($result);

Example response, 200

{
  "id": "cv_ban2ezvpwf4j4d09h4htv42j",
  "object": "conversion",
  "livemode": true,
  "created": "2026-10-12T11:00:30.000Z",
  "updated": "2026-10-12T11:00:30.000Z",
  "status": "awaiting_approval",
  "pending_reason": null,
  "venue": "relay",
  "venue_progress": null,
  "from": {
    "wallet": "wal_zjdztygt4g73zm0cdcjjf43k",
    "asset": "bitcoin:btc",
    "amount": "0.01000000"
  },
  "to": {
    "wallet": "wal_bsfw07hymawmda7gg8jsyy3g",
    "asset": "base:usdc",
    "amount_estimated": "1168.420000",
    "amount_minimum": "1162.577900",
    "amount_received": null
  },
  "rate": "116842.00",
  "max_slippage_bps": 50,
  "fees": [
    {
      "kind": "route_fee",
      "amount": "1.38",
      "currency": "USD"
    },
    {
      "kind": "network_fee",
      "amount": "0.61",
      "currency": "USD"
    }
  ],
  "in_transit_notice": "While a conversion is being routed it is held by Relay, a separate company. Orrerie never holds it.",
  "requested_by": {
    "type": "api_key",
    "id": "key_6e3gg2c6ea176xxdek2nar6v"
  },
  "approved_by": null,
  "approval_url": "https://merchant.orrerie.com/approve/cv_ban2ezvpwf4j4d09h4htv42j",
  "approval_expires_at": "2026-10-19T11:00:30.000Z",
  "send_transaction_hash": null,
  "receive_transaction_hash": null,
  "failure_code": null,
  "cancellation_reason": null,
  "approved_at": null,
  "sent_at": null,
  "confirmed_at": null,
  "metadata": {}
}