List orders
Lists your orders, newest first. status is the only filter.
Query Parameters
Page size. The API caps values above 100 at 100.
An order made with an API key starts as pending, and Gravv debits its source at once. It then becomes completed, or cancelled if the debit fails. waiting_approval is for orders made in the Dashboard.
Possible values: waiting_approval, pending, completed, rejected, cancelled
Responses
| Status | Description |
|---|---|
200 |
A page of orders |
400 |
The request failed. Every FX error is a 400, including not-found and outages. Read error. |
200 response
An order made with an API key starts as pending, and Gravv debits its source at once. It then becomes completed, or cancelled if the debit fails. waiting_approval is for orders made in the Dashboard.
Possible values: waiting_approval, pending, completed, rejected, cancelled
The amount sold
The amount bought
Possible values: internal_account, internal_crypto_wallet
Possible values: internal_account, internal_crypto_wallet, external_account
Possible values: market
Which rate table priced the order
Only on orders made through the trade desk
{
"data": {
"items": [
{
"id": "2d4f6a8c-1b3d-4e5f-8a7b-9c0d1e2f3a4b",
"quote_id": "GRVOTC_3F9A1C",
"status": "pending",
"from_currency": "USD",
"to_currency": "XAF",
"rate": "605.25",
"source_amount": "10000",
"destination_amount": "6052500",
"source_type": "internal_account",
"source_id": "4b3a2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d",
"destination_type": "external_account",
"destination_id": "b7e1c2d3-4f5a-4b6c-9d8e-7f6a5b4c3d2e",
"order_type": "market",
"client_reference": "inv-2026-1042",
"metadata": {
"desk": "treasury"
},
"created_at": "2026-10-12T09:21:04Z"
}
],
"items_per_page": 20,
"page": 1,
"total_items": 1,
"total_pages": 1
},
"error": null
}
400 response
What went wrong. FX errors carry no code.
{
"data": null,
"error": "order not found"
}
Authorization
- ApiKeyAuth