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

# Quote a transfer

> Quotes a transfer to an already whitelisted recipient. USD bank transfers require the authenticated merchant's verified Tier 2 business profile and approved USD banking capability; no customer identity is accepted as the transfer principal.



## OpenAPI

````yaml /openapi.json post /v1/transfers/quotes
openapi: 3.0.3
info:
  contact:
    email: support@yara.cash
    name: Yara API Support
  description: >-
    Merchant-facing wallets/address-as-a-service API for creating merchant
    receive addresses, inspecting balances, quoting transfers, and initiating
    payouts to whitelisted recipients.

    Public endpoints are for external integrators. Dashboard endpoints are
    gateway-to-environment surfaces protected by the external API gateway.
    Internal endpoints are platform/system surfaces protected by an internal
    token.
  license:
    name: Proprietary
  title: Yara External API - Public API
  version: '1.0'
servers:
  - url: https://api.yara.cash
security: []
paths:
  /v1/transfers/quotes:
    post:
      tags:
        - public.transfers
      summary: Quote a transfer
      description: >-
        Quotes a transfer to an already whitelisted recipient. USD bank
        transfers require the authenticated merchant's verified Tier 2 business
        profile and approved USD banking capability; no customer identity is
        accepted as the transfer principal.
      parameters:
        - description: Idempotency key
          in: header
          name: X-Idempotency-Key
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferQuoteRequest'
        description: Transfer quote request
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferQuoteResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    TransferQuoteRequest:
      properties:
        amount:
          $ref: '#/components/schemas/TransferQuoteAmountRequest'
        funding_source:
          $ref: '#/components/schemas/TransferFundingSourceRequest'
        recipient_id:
          example: 3bf24579-a35a-4ba9-a936-5df9c1d809f9
          type: string
      type: object
    TransferQuoteResponse:
      properties:
        data:
          $ref: '#/components/schemas/TransferQuote'
      type: object
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorBody'
      type: object
    TransferQuoteAmountRequest:
      properties:
        currency:
          example: USD
          type: string
        value:
          example: '100.00'
          type: string
      type: object
    TransferFundingSourceRequest:
      properties:
        asset:
          example: USDC
          type: string
        currency:
          example: NGN
          type: string
        method:
          example: BANK_TRANSFER
          type: string
        network:
          example: BASE
          type: string
      type: object
    TransferQuote:
      properties:
        destination_amount:
          $ref: '#/components/schemas/TransferAmount'
        destination_rail:
          example: US_BANK_ACCOUNT
          type: string
        expires_at:
          example: '2026-06-16T03:05:00Z'
          type: string
        funding:
          $ref: '#/components/schemas/TransferFundingQuote'
        id:
          example: 0e0f7b9c-f47b-4f42-b56e-991b8f7a1cb3
          type: string
        status:
          example: ACTIVE
          type: string
        total_debit:
          $ref: '#/components/schemas/TransferAmount'
        transfer_fee:
          $ref: '#/components/schemas/TransferAmount'
      type: object
    ErrorBody:
      properties:
        code:
          example: validation_error
          type: string
        message:
          example: invalid JSON body
          type: string
      type: object
    TransferAmount:
      properties:
        asset:
          example: USDC
          type: string
        currency:
          example: USD
          type: string
        network:
          example: BASE
          type: string
        value:
          example: '100.00'
          type: string
      type: object
    TransferFundingQuote:
      properties:
        expires_at:
          example: '2026-06-16T03:05:00Z'
          type: string
        fee:
          $ref: '#/components/schemas/TransferAmount'
        method:
          example: BANK_TRANSFER
          type: string
        rate:
          $ref: '#/components/schemas/TransferFundingRate'
        required_amount:
          $ref: '#/components/schemas/TransferAmount'
      type: object
    TransferFundingRate:
      properties:
        base_currency:
          example: USD
          type: string
        quote_currency:
          example: NGN
          type: string
        value:
          example: '1600'
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'Public merchant API key. You can also send Authorization: ApiKey <key>.'
      in: header
      name: X-Yara-API-Key
      type: apiKey

````