# Legacy API

Version: 1.3

## Servers

```
https://api.banxa.com
```

## Security

### sec0

Type: apiKey
In: header
Name: Authorization

## Download OpenAPI description

[Legacy API](https://docs.banxa.com/_bundle/products/legacy-api/openapi.yaml)

## Other

### Get Fiat Currencies

 - [GET /api/fiats/{orderType}](https://docs.banxa.com/products/legacy-api/openapi/other/get-fiat-currencies.md): Retrieve all available fiat currencies

### Get Cryptocurrencies

 - [GET /api/coins/{orderType}](https://docs.banxa.com/products/legacy-api/openapi/other/get-crypto-currencies.md): Retrieve all available cryptocurrencies

### Get Countries

 - [GET /api/countries](https://docs.banxa.com/products/legacy-api/openapi/other/get-countries.md): Retrieve all available countries

### Get US States

 - [GET /api/countries/us/states](https://docs.banxa.com/products/legacy-api/openapi/other/get-us-states.md): Retrieve all available US States

### Get Payment Methods

 - [GET /api/payment-methods](https://docs.banxa.com/products/legacy-api/openapi/other/get-payment-methods.md): Retrieve all possible payment methods or filter the available by a fiat or coin code. The type of exchange is determined based on the codes provided to the source and target.

If the payment has a supported_agents field which is not null then there are limitations for accessing this payment by browser and operating system. To avoid the payment failing please block customers from accessing those payments from the wrong device

### Get Prices

 - [GET /api/prices](https://docs.banxa.com/products/legacy-api/openapi/other/get-prices.md): Get prices for all available payment methods or for a single payment method. Note that this endpoint should only be called when a user requests prices by providing the cryptocurrency, fiat and ideally amounts and payment method. This endpoint is for dynamic quotations and not to retrieve a list of static prices that can be cached. As a result, the endpoint is rate limited.

### Create Order

 - [POST /api/orders](https://docs.banxa.com/products/legacy-api/openapi/other/create-order.md): Allows your customer to create a buy or sell crypto order with Banxa. Upon success, the response will contain a checkout URL which will be unique for the order. The customer will  be redirected to this URL to complete the checkout process, which will expire after 1 minute if a redirect does not occur.

### Get Orders (Bulk Orders)

 - [GET /api/orders](https://docs.banxa.com/products/legacy-api/openapi/other/get-orders.md): Retrieves details for a bulk of orders that have been submitted within a given time range and optionally by order status or customer.

### Create NFT Order

 - [POST /api/orders/nft/buy](https://docs.banxa.com/products/legacy-api/openapi/other/create-nft-order.md): Allows your customer to create a Fiat to NFT order with Banxa. Upon success, the response will contain a checkout URL which will be unique for the order. The customer will  be redirected to this URL to complete the checkout process, which will expire after 1 minute if a redirect does not occur.

### Get Order (Single Order)

 - [GET /api/orders/{order_id}](https://docs.banxa.com/products/legacy-api/openapi/other/get-order.md): Retrieves details for single order that has been submitted

### Confirm Sell Order

 - [POST /api/orders/{order_id}/confirm](https://docs.banxa.com/products/legacy-api/openapi/other/confirm-sell-order.md): Once the coin amount transfer for a Sell Order has been executed, Banxa must be notified by sending a request to this endpoint with transaction hash, source and destination wallet address details.

### KYC Sharing Customer Registration

 - [POST /api/identities](https://docs.banxa.com/products/legacy-api/openapi/other/create-identity.md): Allows you to share customer details with Banxa before an Order is created. This reduces the need for customers to re-submit personal details and upload KYC documentation during the Banxa checkout flow. Detailed guide on how to implement this API can be found here.

This endpoint is restricted and subject to Banxa approval.

### KYC Reliance Customer Registration

 - [POST /api/identities/reliance](https://docs.banxa.com/products/legacy-api/openapi/other/kyc-reliance-customer-registration-1.md): Allows you to register customer details with Banxa before an Order is created. This reduces the need for customers to re-submit personal details and perform KYC during the Banxa checkout flow. Detailed guide on how to implement this API can be found here.

This endpoint is restricted and subject to Banxa approval.