> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincode.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported Currencies

> Retrieves the list of supported currencies for a specific remittance corridor and delivery method.

This endpoint is the final step in determining the valid parameters for initiating a transaction. It retrieves all supported payout currencies for the specified **sending country**, **receiving country**, and **delivery method**.

## Request Headers

This endpoint requires a valid **Access Token**

<ParamField header="X-Auth-Token" type="string" required>
  The **JWT Access Token** obtained from the `/login` or `/refresh-token`
  endpoint. This token must belong to a user with appropriate permissions (e.g.,
  `MANAGER` or `AGENT`).
</ParamField>

<ParamField header="platform" type="string" required default="fincode">
        Platform identifier. Use `fincode`.
</ParamField>

<ParamField header="uuid" type="string" required default="200">
        Unique request identifier.
</ParamField>

## Path Parameters

All path parameters are mandatory to define the specific corridor.

<ParamField path="sendingCountryCode" type="string" required default="GBR">
  The **country code** the customer is sending from (ISO 3166-1 alpha-3 code).
</ParamField>

<ParamField path="receivingCountryCode" type="string" required default="NGA">
  The **country code** the recipient is in (ISO 3166-1 alpha-3 code).
</ParamField>

<ParamField path="deliveryMethod" type="string" required default="ACCOUNTPAYMENT">
  The intended **payout method** (e.g., `ACCOUNTPAYMENT`, `CASH_PICKUP`).
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --location 'https://remitjunction.fincode.software/api/v6/services/quote/supported-currencies/GBR/NGA/ACCOUNTPAYMENT' \
  --header 'platform: fincode' \
  --header 'uuid: 200'
  ```

  ```javascript Node.js theme={null}
  const axios = require('axios');

  const BASE_URL = 'https://agent.fincode.software/api/v6/services/quote';

  async function getSupportedCurrencies(
    sendCountry,
    receiveCountry,
    deliveryMethod
  ) {
    const url = `${BASE_URL}/supported-currencies/${sendCountry}/${receiveCountry}/${deliveryMethod}`;
    try {
      const response = await axios.get(url, {
        headers: {
          platform: 'fincode',
          uuid: '200',
        },
      });

      const currencies = response.data.data;

      console.log(
        `Supported Payout Currencies for ${sendCountry} to ${receiveCountry} via ${deliveryMethod}:`
      );
      currencies.forEach((c) => {
        console.log(
          `- ${c.currencyName} (${c.currencyCode}) - Min: ${c.minAmount}, Max: ${c.maxAmount}`
        );
      });

      return currencies;
    } catch (error) {
      console.error(
        'Failed to fetch supported currencies:',
        error.response?.data || error.message
      );
      throw error;
    }
  }

  ```
</CodeGroup>


## OpenAPI

````yaml GET /quote/supported-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}
openapi: 3.0.0
info:
  title: FinCode API
  version: v6
servers:
  - url: https://{tenant}.fincode.software/api/v6/services
    description: API v6
    variables:
      tenant:
        default: remitjunction
        description: Enter your tenant subdomain
  - url: https://{tenant}.fincode.software/api/v1/services
    description: API v1
    variables:
      tenant:
        default: finlend
        description: Enter your tenant subdomain
  - url: https://api.stag.songhaiexchange.io
    description: Songhai Exchange API
security: []
paths:
  /quote/supported-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}:
    get:
      summary: Supported Currencies
      description: Retrieves supported currencies for corridor
      operationId: supportedCurrencies
      parameters:
        - $ref: '#/components/parameters/platformHeader'
        - $ref: '#/components/parameters/uuidHeader'
        - in: header
          name: X-Auth-Token
          schema:
            type: string
          required: true
        - in: path
          name: sendingCountryCode
          schema:
            type: string
            default: GBR
          required: true
        - in: path
          name: receivingCountryCode
          schema:
            type: string
            default: NGA
          required: true
        - in: path
          name: deliveryMethod
          schema:
            type: string
            default: ACCOUNTPAYMENT
          required: true
      responses:
        '200':
          description: List of supported currencies
components:
  parameters:
    platformHeader:
      in: header
      name: platform
      schema:
        type: string
        default: fincode
      required: true
    uuidHeader:
      in: header
      name: uuid
      schema:
        type: string
        default: '200'
      required: true

````