Skip to main content
GET
Get an order

Authorizations

Authorization
string
header
required

Your Jenzy API key: Authorization: Bearer jz_live_…

Path Parameters

id
string
required

The order id (UUID).

Response

The order.

id
string<uuid>
required

The order id — your handle for polling and support.

client_ref
string
required
Example:

"inv-1042"

from_asset
string
required

An asset code as GET /v2/assets lists it — uppercase, never compound (KES, USDT; never USDT-TRON). Network and rail live on the payment object.

Minimum string length: 1
Example:

"USDT"

from_amount
string
required

What you pay, in from_asset. On a to-bank order this is held from your balance at creation.

Example:

"1000"

to_asset
string
required

An asset code as GET /v2/assets lists it — uppercase, never compound (KES, USDT; never USDT-TRON). Network and rail live on the payment object.

Minimum string length: 1
Example:

"BIF"

to_amount
string
required

What the beneficiary receives (to-bank order) or you are credited (from-bank order), in to_asset.

Example:

"2850500"

rate
string
required

The quote’s rate: corridor currency per one stablecoin.

Example:

"2850.5"

status
enum<string>
required

To-bank order: accepted (your stablecoin is held) → processing (the desk is paying the beneficiary) → completed | failed | cancelled. From-bank order: awaiting_instructions → awaiting_funds (see funding; wire before expires_at) → proof_submitted → funds_confirmed → completed | expired | failed | cancelled. There is no cancel endpoint; ask Jenzy operations.

Available options:
accepted,
processing,
awaiting_instructions,
awaiting_funds,
proof_submitted,
funds_confirmed,
expired,
completed,
failed,
cancelled
Example:

"accepted"

failure
object | null
required

Set only on failed: one of the published codes with its fixed message.

proofs
object
required

Your newest funding proof on a from-bank order, if any.

created_at
string<date-time>
required
updated_at
string<date-time>
required
refund
object

Present on a to-bank order that failed after the coins had left. pending — your stablecoin is on its way back; returned — it has been credited to your balance as a collection.

beneficiary
object

To-bank orders only, exactly as you sent it.

funding
object

From-bank orders only, present from awaiting_funds: where to wire your from_amount. Immutable once set.

expires_at
string<date-time>

From-bank orders only: the funding deadline. Past it with no proof the order is expired.