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

# Get Quote

> Retrieves the details of a previously created exchange quote using the unique quoteId.



## OpenAPI

````yaml get /v1/quote/{quoteId}
openapi: 3.0.3
info:
  title: meCash API
  version: 3.0.3
  description: >-
    API for meCash services, including FIAT and Ramp operations. This is the
    OpenAPI specification for the meCash API, covering all available endpoints
    for wallet management, currency quotes, and payouts.


    It follows a design-first approach based on OpenAPI 3.0.


    Authentication is handled via an API key passed in the `x-api-key` header.
    Replace `YOUR_API_KEY` with your actual key when making requests.


    Some useful links:

    - [meCash Documentation](https://docs.me-cash.com/)

    - [Authentication Guide](https://docs.me-cash.com/authentication)
servers:
  - url: https://sandboxapi.me-cash.com
    description: Sandbox Server for Testing
security:
  - ApiKeyAuth: []
tags:
  - name: Wallet
    description: Wallet management operations
  - name: Quote
    description: Currency quote operations
  - name: Payout
    description: Payout operations
  - name: Transaction
    description: Transaction management
  - name: Virtual Account
    description: Virtual account operations for static and dynamic accounts
  - name: Bank
    description: Bank account and list operations
  - name: Ramp
    description: Ramp operations for crypto
  - name: Miscellaneous
    description: Utility and miscellaneous operations
  - name: Collection
    description: Mobile money and wallet funding operations
  - name: Bulk Payout
    description: >-
      Bulk transfer operations for sending to multiple beneficiaries in a single
      request
paths:
  /v1/quote/{quoteId}:
    get:
      tags:
        - Quote
      summary: Get Quote Details
      description: >-
        Retrieves the details of a previously created exchange quote using the
        unique quoteId.
      operationId: getQuoteById
      parameters:
        - name: quoteId
          in: path
          required: true
          description: The unique identifier of the quote.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          $ref: '#/components/responses/GetQuoteSuccess'
        '400':
          $ref: '#/components/responses/QuoteBadRequest'
        '401':
          $ref: '#/components/responses/PayoutUnauthorized'
        '403':
          $ref: '#/components/responses/PayoutForbidden'
        '404':
          $ref: '#/components/responses/QuoteNotFound'
        '500':
          $ref: '#/components/responses/PayoutInternalServerError'
components:
  responses:
    GetQuoteSuccess:
      description: Quote details retrieved successfully.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: quote successfully fetched
              status:
                type: string
                example: success
              data:
                $ref: '#/components/schemas/CreateQuoteSuccessData'
    QuoteBadRequest:
      description: Bad Request. The request could not be processed due to a client error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/QuoteFailedResponse'
          examples:
            InvalidAPIKey:
              summary: Invalid API Key
              value:
                message: Invalid API key
                status: failed
            QuoteNotFoundExample:
              summary: Quote Not Found
              value:
                message: Quote does not exist
                status: failed
    PayoutUnauthorized:
      description: Unauthorized. The provided API key is invalid or missing.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: Invalid API key
            status: failed
    PayoutForbidden:
      description: >-
        Forbidden. The request is not allowed because the source IP is not
        whitelisted.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: 'Access denied: IP address not whitelisted'
            status: failed
    QuoteNotFound:
      description: Not Found. The quote with the specified ID was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: Quote does not exist
            status: failed
    PayoutInternalServerError:
      description: Internal Server Error. The server failed to process the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: Server failed to process request.
            status: failed
  schemas:
    CreateQuoteSuccessData:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: e5eec724-38f9-40e2-9i86-xxxxxxxxxxxxx
        paymentChannel:
          $ref: '#/components/schemas/PaymentChannel'
        source:
          type: object
          properties:
            currency:
              type: string
              example: NGN
            country:
              type: string
              example: NG
            amount:
              type: number
              example: 150000
        target:
          type: object
          properties:
            currency:
              type: string
              example: USD
            country:
              type: string
              example: US
            amount:
              type: number
              example: 81.97
        rate:
          type: number
          example: 1830
        fee:
          type: object
          properties:
            amount:
              type: number
              example: 0
            stampDuty:
              type: number
              example: 0
        rules:
          type: array
          items:
            type: object
            properties:
              category:
                type: string
                example: LIMIT
              appliedCurrency:
                type: string
                example: USD
              appliedCountry:
                type: string
                example: US
              transaction:
                type: object
                properties:
                  minimum:
                    type: number
                    example: 1
                  maximum:
                    type: number
                    example: 20000000000000
              invoice:
                type: number
                example: 200000000000
        summary:
          type: object
          properties:
            total:
              type: number
              example: 150000
        settlementTime:
          type: string
          example: 1 hr
        settlement:
          type: string
          example: 1 hr
        quoteCurrency:
          type: string
          example: USD
        expiresInSeconds:
          type: integer
          example: 600
    QuoteFailedResponse:
      type: object
      properties:
        message:
          type: string
        status:
          type: string
          example: failed
      required:
        - message
        - status
    PayoutFailedResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message.
        status:
          type: string
          example: failed
      required:
        - message
        - status
    PaymentChannel:
      type: string
      description: >-
        The channel through which the payment will be processed. For SWIFT
        transfers, use `SWIFT_CUSTOMER` (sender/customer bears all transfer
        charges), `SWIFT_SHARED` (charges split between sender and beneficiary),
        or `SWIFT_BENEFICIARY` (beneficiary bears all transfer charges).
      example: BANK_TRANSFER
      enum:
        - BANK_TRANSFER
        - INTERAC
        - SWIFT_CUSTOMER
        - SWIFT_SHARED
        - SWIFT_BENEFICIARY
        - MOBILE_MONEY
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````