> ## 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.

# Delivery Currencies

> Retrieves the list of currencies available for the recipient to receive, given the sender's payment currency.

This endpoint finalizes the currency selection by returning the payout currencies available in the destination country.

It factors in the corridor and the specific **source currency** (`sendingCurrencyCode`) that the sender has chosen to pay with.

## 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.
</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

<ParamField path="sendingCountryCode" type="string" required default="GBR">
  The country code the customer is sending from.
</ParamField>

<ParamField path="receivingCountryCode" type="string" required default="NGA">
  The country code the recipient is in.
</ParamField>

<ParamField path="deliveryMethod" type="string" required default="ACCOUNTPAYMENT">
  The intended payout method.
</ParamField>

<ParamField path="sendingCurrencyCode" type="string" required default="GBP">
  The specific **source currency** the sender is paying with (e.g., `GBP`). This
  is the new parameter.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --location 'https://remitjunction.fincode.software/api/v6/services/quote/supported-delivery-currencies/GBR/NGA/ACCOUNTPAYMENT/GBP' \
  --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 getSupportedDeliveryCurrencies(
    sendCountry,
    receiveCountry,
    deliveryMethod,
    sendCurrency
  ) {
    const url = `${BASE_URL}/supported-delivery-currencies/${sendCountry}/${receiveCountry}/${deliveryMethod}/${sendCurrency}`;
    try {
      const response = await axios.get(url, {
        headers: {
          platform: 'fincode',
          uuid: '200',
        },
      });

      const currencies = response.data.data;

      console.log(
        `Final Delivery Currencies available for ${sendCurrency} payment:`
      );
      currencies.forEach((c) => {
        console.log(
          `- Receive in ${c.currencyCode} (Range: ${c.minAmount} to ${c.maxAmount})`
        );
      });
      return currencies;
    } catch (error) {
      console.error(
        'Failed to fetch supported delivery currencies:',
        error.response?.data || error.message
      );
      throw error;
    }
  }

  ```
</CodeGroup>


## OpenAPI

````yaml GET /quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}
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-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}:
    get:
      summary: Delivery Currencies
      description: Retrieves supported delivery currencies
      operationId: supportedDeliveryCurrencies
      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
        - in: path
          name: sendingCurrencyCode
          schema:
            type: string
            default: GBP
          required: true
      responses:
        '200':
          description: List of delivery 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

````