# List Quotes

**GET** `/quotes`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

Get a list of quotes created

## Authorization

- oauth2 (http, bearer)

## Responses

### 200

OK

- `id` (string<uuid>)
  Transfer Identifier
- `external_id` (string)
  Transfer Reference provided by API caller
- `mode` ("sending" | "receiving")
  `sending` mode allow users to specify the `sending_amount` and get a quote for `receiving_amount`; `receiving` mode allows users to specify the `receiving_amount` and get a quote for `sending_amount`.
- `source_country` (string<iso-3166-1-alpha3>)
  Country code funds sent from (ISO-3166-1), e.g. USA
- `destination_country` (string<iso-3166-1-alpha3>)
  Country code funds sent to (ISO-3166-1), e.g. USA
- `destination_account_type` ("bank_account" | "digital_wallet" | "cash_pickup" | "card")
  The Account Type to receive funds
- `sending_amount` (number<double>)
  Sending amount
- `sending_currency` (string<iso-4217-ext>)
  Sending Currency which is defined by /currencies.
- `receiving_amount` (number<double>)
  Receiving amount
- `receiving_currency` (string<iso-4217-ext>)
  Receiving Currency which is defined by /currencies.
- `exchange_rate` (number<double>)
  The exchange rate from sending currency to receiving currency, e.g. 1 BTC = 57151.5 USD.
- `fee` (number<double>)
  This indicates the amount which will be debit from merchant's balance with `balance_id` for this transfer.
- `fee_currency` (string<iso-4217-ext>)
  Iso-4217 for `fiat_money` (i.e., local currency), non-iso-4217 listed here (https://en.wikipedia.org/wiki/ISO_4217) for `cyptocurrency`'
- `expires_at` (string<date-time>)
- `charge_type` ("OUR" | "SHA")
  To specify which party bears the bank fee. **OUR** means that the initiator will pay the fee, which means an additional fee when you create the transfer. **SHA** means that both the initiator and the recipient will pay the fee. Some fees will be deducted from the amount sent by the intermediary banks
- `intermediary_bank_fee` (number<double>)
  Indicates the intermediary bank charge. It will follow the sending currency.
- `conditions` (object)
  Conditions that a transfer must meet before it can be processed
  - `document_types` (object)
    - `transfer_purpose` (string)

Example:

```json
{
  "id": "00000000-0000-0000-0000-000000000000",
  "external_id": "string",
  "mode": "sending",
  "source_country": "USA",
  "destination_country": "CHN",
  "destination_account_type": "bank_account",
  "sending_amount": 0.01,
  "sending_currency": "BTC",
  "receiving_amount": 57.15,
  "receiving_currency": "USD",
  "exchange_rate": 57151.5,
  "fee": 57.15,
  "fee_currency": "USD",
  "expires_at": "2023-07-13T15:31:02.886Z",
  "charge_type": "SHA",
  "intermediary_bank_fee": 25,
  "conditions": {
    "document_types": {
      "transfer_purpose": "string"
    }
  }
}
```

### 404

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 500

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```