Crypto Ramp API
Retrieve an order
api
get
/orders/{order_id}

Retrieve an order

Retrieve an order by order_id provided in the path and the wallet address provided as a query parameter.

For more information, see the guides: Leverage the Crypto Ramp API -> Get an order.

X-API-KEY

Each Crypto Ramp API request must contain an authorization header in the following format to make a call: X-API-KEY: {your_API_key}.

Before you start, make sure that you have the correct API key. For more information, see the Get started guides: Integrate with Revolut Ramp -> 2. Get Partner keys.

Request

Path Parameters
Path Parameters

The external identifier of the order to retrieve. Should be either UUID or ULID.

Query Parameters
Query Parameters

The address of the crypto wallet into which the token transfer was ordered.

Header Parameters
Header Parameters

Your API key that you received during integration setup. For more information, see the Authorization section above.

Response

OK

Response body
Body object 

The external UUID of the order.

Example: {"amount":100,"currency":"USD"}

The fiat amount that the customer paid for the crypto (excluding fees).

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

Example: {"amount":100,"currencyId":"USDT-ETH"}

The crypto amount that the customer received.

The amount.

Example: "USDT-ETH"

The ID of the currency, obtained from the /config endpoint.

The fees for the order.

Example: {"amount":100,"currency":"USD"}

Revolut Ramp fee.

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

Example: {"amount":100,"currency":"USD"}

Partner fee.

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

Example: {"amount":100,"currency":"USD"}

Crypto network fee.

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

The exchange rate for the order.

Possible values: [card, revolut, apple-pay, google-pay]

The payment method used for the purchase.

The UTC date and time of order creation in ISO 8601 format.

The UTC date and time of order update in the ISO 8601 format.

Possible values: [AWAITING_PAYMENT, PROCESSING, COMPLETED, FAILED]

The state of order processing.

Possible values: [PAYMENT_NOT_RECEIVED, PAYMENT_DECLINED, CRYPTO_WITHDRAWAL_FAILED, OTHER]

The reason why the order failed.

The address of the crypto wallet into which the crypto transfer was ordered.

The blockchain transaction hash. Absent if no crypto transaction has been created yet. Always present if order is in the COMPLETED state.

The additional properties passed in the call to the /buy endpoint under the additionalProperties.* query parameter(s), if such properties were provided.

The fees converted to the partner's currency.

Example: {"amount":100,"currency":"USD"}

Revolut Ramp fee.

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

Example: {"amount":100,"currency":"USD"}

Partner fee.

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

Example: {"amount":100,"currency":"USD"}

Crypto network fee.

The amount.

Example: "GBP"

The fiat currency ISO 4217 code.

Was this page helpful?
Loading...