Get order details and on-chain transactions by order ID

Use the PeerPesa order details endpoint to fetch a single order by its order_id. The response includes the full order record plus the transactions array, so you can track each leg of a swap, send, buy, withdraw, or deposit down to its blockchain tx_hash.

GET /orders/{order_id}

Returns one order with its transactions.

string

required

The order’s order_id, for example 22573706304032. Get it from List Orders or from the response when you create an order.

curl https://api.peerpesa.co/v1/orders/22573706304032 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const res = await fetch("https://api.peerpesa.co/v1/orders/22573706304032", {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const order = await res.json();

The order object

This cUSD to USDT swap on Celo shows a complete order:

Response

{
  "id": "7e158a76-9c0e-40c8-80b3-a17dc9a78dd1",
  "order_id": "22573706304032",
  "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
  "asset_id": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
  "network_id": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
  "asset": "cUSD",
  "network": "cusd",
  "network_to": "usdt",
  "from_network": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
  "to_network": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
  "amount": 2.87942,
  "total_amount": 2.87942,
  "network_fee": 0,
  "exchange_fee": 0,
  "total_fees": 0,
  "receive_amount": 2.87942,
  "from_amount": 2.87942,
  "to_amount": 2.87942,
  "from_asset_amount": 2.87942,
  "to_asset_amount": 2.87942,
  "from_asset": "cUSD",
  "from_asset_id": "3bb5afa7-947b-4de2-9876-40ec67d174ab",
  "to_asset": "USDT",
  "to_asset_id": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
  "country": null,
  "sender_address": "0xD87f36fe3578ad0F1437470826FCbc010b26e27b",
  "recipient_address": "0x15cb5Ab94aEfd21A5458FEda25583C9938E83c74",
  "memo": "",
  "mode_of_payment": "",
  "payment_method_id": null,
  "account_number": null,
  "payment_details": null,
  "channel_id": null,
  "provider_network_id": null,
  "provider_channel_id": null,
  "fiat_currency": null,
  "reason": null,
  "cancelled_by": null,
  "cancel_reason": null,
  "cancel_date": null,
  "order_type": "swap",
  "status": "successful",
  "slippage": null,
  "exchange_rate": 1,
  "recurring_payment": "",
  "created_at": "2026-07-23T05:33:48.000Z",
  "updated_at": "2026-07-23T05:42:00.000Z",
  "deleted_at": null,
  "transactions": [
    {
      "id": "54811f9f-2651-4343-ba02-c6c3086f124f",
      "transaction_id": "40023360527002",
      "recurring_payment_invoice_id": "",
      "order_id": "22573706304032",
      "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
      "transaction_type": "swap",
      "transfer_type": "token",
      "amount": 2.77942,
      "currency": "cUSD",
      "base_currency": "",
      "quote_currency": "",
      "sell_amount": 0,
      "buy_amount": 0,
      "exchange_rate": "0.00000000",
      "ico_unit_price": 0,
      "to_wallet": "0x4853f1da97B1a7bE8eDc23D8d4372d20c27eF84c",
      "from_wallet": "0xD87f36fe3578ad0F1437470826FCbc010b26e27b",
      "account_number": null,
      "tx_hash": "0xfe4d176771863cbc165c263521859e15bb9b26d3392dcbfa86fec1c7c7183379",
      "status": "completed",
      "transaction_description": "",
      "service_type": null,
      "memo": "",
      "approved_by": "",
      "cancelled_by": "",
      "transaction_fee_system": 0,
      "transaction_fee": 0,
      "transaction_fee_ico": "CUSD",
      "transaction_error": null,
      "transaction_admin_info": null,
      "transaction_message": null,
      "third_party_status": "",
      "payment_object": "",
      "request_obj": "",
      "deleted_at": null,
      "updated_at": "2026-07-23T05:38:02.000Z",
      "created_at": "2026-07-23T05:34:00.000Z"
    },
    {
      "id": "0607feb4-0a4c-4ad7-a0ef-78798f7da34d",
      "transaction_id": "07920032325060",
      "recurring_payment_invoice_id": "",
      "order_id": "22573706304032",
      "user_id": "0000-0000-0000-0000",
      "transaction_type": "swap",
      "transfer_type": "token",
      "amount": 2.87942,
      "currency": "USDT",
      "base_currency": "",
      "quote_currency": "",
      "sell_amount": 0,
      "buy_amount": 0,
      "exchange_rate": "0.00000000",
      "ico_unit_price": 0,
      "to_wallet": "0x15cb5Ab94aEfd21A5458FEda25583C9938E83c74",
      "from_wallet": "0xB69faFF50c3d17f0C0025269369dF77172137054",
      "account_number": null,
      "tx_hash": "0x3adb8ea5e555d45690ccf6330dd27e221e6270ccf775bd7e7e722d2ba4dbc91d",
      "status": "completed",
      "transaction_description": "",
      "service_type": null,
      "memo": "",
      "approved_by": "",
      "cancelled_by": "",
      "transaction_fee_system": 0,
      "transaction_fee": 0,
      "transaction_fee_ico": "USDT",
      "transaction_error": "",
      "transaction_admin_info": null,
      "transaction_message": null,
      "third_party_status": "",
      "payment_object": "",
      "request_obj": "",
      "deleted_at": null,
      "updated_at": "2026-07-23T05:41:01.000Z",
      "created_at": "2026-07-23T05:39:00.000Z"
    }
  ]
}

Amounts and fees on orders are returned as numbers. Transactions with user_id 0000-0000-0000-0000 are PeerPesa system legs, such as the payout that delivers the swapped asset to the recipient.

Order fields

string

Internal order record ID (UUID).

string

Public order number. Use it with GET /orders/{order_id} and in support requests.

string

ID of the account that placed the order.

string

Kind of order, for example swap.

string

Order status, for example successful.

string

Asset the order was placed in, for example cUSD.

string

ID of the order asset.

string

Source network or asset code, for example cusd.

string

Destination network or asset code, for example usdt.

string

ID of the order’s network.

string

Network ID the funds left from.

string

Network ID the funds arrived on.

string

Asset sent, for example cUSD. from_asset_id holds its ID.

string

Asset received, for example USDT. to_asset_id holds its ID.

number

Order amount in the source asset.

number

Total debited from your balance, including fees.

number

Amount sent. from_asset_amount holds the same value in source asset units.

number

Amount converted into the destination asset. to_asset_amount holds the same value in destination asset units.

number

Amount the recipient received after fees.

number

Blockchain network fee.

number

PeerPesa conversion fee.

number

Sum of network_fee and exchange_fee.

number

Rate applied between from_asset and to_asset.

number | null

Slippage tolerance used for swaps, or null.

string

Wallet address the funds came from.

string

Wallet address the funds were delivered to.

string

Memo sent with the order, for networks such as Stellar. Empty when not used.

string | null

Fiat currency for buy and withdraw orders, for example KES. null for crypto-only orders.

string | null

Country for fiat orders, or null.

string

Fiat payment mode for buy and withdraw orders, for example mobile money or bank. Empty for crypto-only orders.

string | null

Saved payment method used for fiat orders.

string | null

Mobile money or bank account number for fiat orders.

object | null

Extra fiat payment details, when present.

string | null

Payment channel used for fiat orders. provider_network_id and provider_channel_id identify the payout provider’s network and channel.

string | null

Reason or note attached to the order.

string | null

Who cancelled the order, when cancelled. cancel_reason and cancel_date give the reason and time.

string

ID of the recurring payment that created this order. Empty for one-off orders.

string

ISO 8601 timestamp when the order was created. updated_at and deleted_at track later changes.

object[]

On-chain or ledger transactions that carried out the order.

Show transaction properties

string

Internal transaction record ID.

string

Public transaction number.

string

Order this transaction belongs to.

string

Account the transaction applies to. 0000-0000-0000-0000 marks a PeerPesa system leg.

string

Recurring payment run that created it. Empty otherwise.

string

Type matching the order, for example swap.

string

How value moved, for example token.

number

Amount moved in this leg.

string

Asset moved in this leg, for example cUSD.

string

Sending wallet address.

string

Receiving wallet address.

string

Blockchain transaction hash. Look it up on the network’s block explorer.

string

Transaction status, for example completed.

string

Memo used on this leg, if any.

number

Fee charged on this leg. transaction_fee_ico is the fee currency.

string | null

Error details when the leg failed.

string | null

Fiat account for fiat legs.

string

ISO 8601 timestamp when the leg was created. updated_at tracks the last change.

Some transaction fields, such as base_currency, quote_currency, sell_amount, buy_amount, ico_unit_price, approved_by, transaction_admin_info, third_party_status, payment_object, and request_obj, are reserved for internal use or other order types and are usually empty.

Errors

Code	Status	Cause
`order_not_found`	404	No order with this `order_id` exists for your account.
`unauthorized`	401	Token missing or expired.

See Error Codes for the full list.

​GET /orders/{order_id}

​The order object

​Order fields

​Errors

GET /orders/{order_id}

The order object

Order fields

Errors