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

# Retrieve a quote

> The quote with its route, fees, lock and execution state.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/quotes/{id}
openapi: 3.1.0
info:
  title: Useroutr API
  version: '1'
  description: >-
    Application funding infrastructure. Two authentication layers exist and are
    never interchangeable: developer backends authenticate with an application
    API key (`apiKey`), and the Useroutr dashboard authenticates a human with a
    Useroutr account session (`userSession`, obtained from `/v1/auth/sign-in`).
    Platform operations use the operator platform key. Every response carries an
    `X-Request-ID` header that also appears in error envelopes.
servers:
  - url: https://api.sandbox.useroutr.com
    description: 'Sandbox: ur_test_ keys, Stellar testnet'
  - url: https://api.useroutr.com
    description: 'Production: ur_live_ keys'
security: []
tags:
  - name: Funding Intents
    description: Funding intent lifecycle
  - name: Quotes
    description: 'Route quotes: what a payer must send from a chosen source asset'
  - name: Checkout
    description: Public, token-addressed payer view
  - name: Payments
    description: Observed payments
  - name: Settlements
    description: Settlement state and protocol evidence
  - name: Refunds
    description: Refund requests for payments that did not satisfy an intent
  - name: Ledger
    description: Application balances and ledger entries
  - name: Webhooks
    description: Webhook endpoints, events and deliveries
  - name: Assets
    description: Supported assets
  - name: Applications
    description: Application registration and credentials
  - name: Request logs
    description: Requests made with the application's API keys, kept for 30 days
paths:
  /v1/quotes/{id}:
    get:
      tags:
        - Quotes
      summary: Retrieve a quote
      description: The quote with its route, fees, lock and execution state.
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  object:
                    type: string
                    enum:
                      - quote
                  funding_intent_id:
                    type: string
                  application_id:
                    type: string
                  type:
                    type: string
                    enum:
                      - EXACT_INPUT
                      - EXACT_OUTPUT
                  status:
                    type: string
                    enum:
                      - ACTIVE
                      - SELECTED
                      - LOCKED
                      - EXECUTING
                      - COMPLETED
                      - EXPIRED
                      - FAILED
                      - CANCELLED
                  stellar_network:
                    type: string
                    enum:
                      - testnet
                      - mainnet
                      - local
                  source:
                    type: object
                    properties:
                      network:
                        type: string
                      asset:
                        type: string
                      amount:
                        type: string
                      expected_amount:
                        type: string
                    required:
                      - network
                      - asset
                      - amount
                      - expected_amount
                    additionalProperties: false
                  destination:
                    type: object
                    properties:
                      network:
                        type: string
                      asset:
                        type: string
                      address:
                        type: string
                      amount:
                        type: string
                      minimum_amount:
                        type: string
                    required:
                      - network
                      - asset
                      - address
                      - amount
                      - minimum_amount
                    additionalProperties: false
                  route:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - DIRECT_STELLAR
                          - STELLAR_SWAP
                          - CROSS_CHAIN
                          - COMPOSED
                          - DIRECT_EVM
                      provider:
                        type: string
                      steps:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                            provider:
                              type: string
                            source_asset:
                              type: string
                            destination_asset:
                              type: string
                          required:
                            - type
                            - provider
                            - source_asset
                            - destination_asset
                          additionalProperties: false
                      estimated_duration_seconds:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      confidence:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      price_impact_bps:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      score:
                        type: string
                    required:
                      - type
                      - provider
                      - steps
                      - estimated_duration_seconds
                      - confidence
                      - price_impact_bps
                      - score
                    additionalProperties: false
                  fees:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              enum:
                                - NETWORK
                                - PROVIDER
                                - SWAP
                                - BRIDGE
                                - USEROUTR
                            asset:
                              type: string
                            amount:
                              type: string
                          required:
                            - type
                            - asset
                            - amount
                          additionalProperties: false
                      total:
                        type: string
                    required:
                      - items
                      - total
                    additionalProperties: false
                  exchange_rate:
                    type: string
                  slippage_bps:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  execution:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: string
                          object:
                            type: string
                            enum:
                              - route_execution
                          quote_id:
                            type: string
                          funding_intent_id:
                            type: string
                          provider:
                            type: string
                          route_type:
                            type: string
                            enum:
                              - DIRECT_STELLAR
                              - STELLAR_SWAP
                              - CROSS_CHAIN
                              - COMPOSED
                              - DIRECT_EVM
                          status:
                            type: string
                            enum:
                              - PENDING
                              - SUBMITTED
                              - CONFIRMING
                              - COMPLETED
                              - FAILED
                              - UNKNOWN
                          phase:
                            anyOf:
                              - type: string
                                enum:
                                  - CREATED
                                  - SOURCE_PENDING
                                  - SOURCE_CONFIRMED
                                  - MESSAGE_PENDING
                                  - DESTINATION_PENDING
                                  - DESTINATION_CONFIRMED
                                  - VERIFICATION_PENDING
                                  - COMPLETED
                                  - FAILED
                              - type: 'null'
                          provider_execution_id:
                            type:
                              - string
                              - 'null'
                          transaction_hashes:
                            type: array
                            items:
                              type: string
                          failure:
                            anyOf:
                              - type: object
                                properties:
                                  code:
                                    type: string
                                  message:
                                    type: string
                                required:
                                  - code
                                  - message
                                additionalProperties: false
                              - type: 'null'
                          started_at:
                            type: string
                          completed_at:
                            type:
                              - string
                              - 'null'
                        required:
                          - id
                          - object
                          - quote_id
                          - funding_intent_id
                          - provider
                          - route_type
                          - status
                          - phase
                          - provider_execution_id
                          - transaction_hashes
                          - failure
                          - started_at
                          - completed_at
                        additionalProperties: false
                      - type: 'null'
                  failure:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                  expires_at:
                    type: string
                  lock_expires_at:
                    type:
                      - string
                      - 'null'
                  created_at:
                    type: string
                  updated_at:
                    type: string
                required:
                  - id
                  - object
                  - funding_intent_id
                  - application_id
                  - type
                  - status
                  - stellar_network
                  - source
                  - destination
                  - route
                  - fees
                  - exchange_rate
                  - slippage_bps
                  - execution
                  - failure
                  - expires_at
                  - lock_expires_at
                  - created_at
                  - updated_at
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - BAD_REQUEST
                          - VALIDATION_ERROR
                          - UNAUTHORIZED
                          - FORBIDDEN
                          - NOT_FOUND
                          - CONFLICT
                          - IDEMPOTENCY_KEY_REQUIRED
                          - IDEMPOTENCY_KEY_REUSED
                          - IDEMPOTENCY_REQUEST_IN_PROGRESS
                          - APPLICATION_INACTIVE
                          - INVALID_AMOUNT
                          - UNSUPPORTED_ASSET
                          - INVALID_DESTINATION
                          - INVALID_EXPIRATION
                          - PROTOCOL_REJECTED
                          - PROTOCOL_UNAVAILABLE
                          - NO_ROUTE_AVAILABLE
                          - INSUFFICIENT_INPUT
                          - QUOTE_EXPIRED
                          - QUOTE_NOT_SELECTABLE
                          - QUOTE_NOT_LOCKED
                          - EXECUTION_NOT_FAILED
                          - EXECUTION_NOT_RESUMABLE
                          - LOGO_FORMAT_UNSUPPORTED
                          - LOGO_DIMENSIONS_INVALID
                          - LOGO_STORAGE_UNAVAILABLE
                          - ROUTE_UNAVAILABLE
                          - RATE_LIMITED
                          - INVALID_CREDENTIALS
                          - EMAIL_NOT_VERIFIED
                          - EMAIL_ALREADY_REGISTERED
                          - SESSION_EXPIRED
                          - INVALID_TOKEN
                          - INTERNAL_ERROR
                      message:
                        type: string
                      requestId:
                        type: string
                      retryable:
                        type: boolean
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            path:
                              type: string
                            message:
                              type: string
                          required:
                            - path
                            - message
                          additionalProperties: false
                    required:
                      - code
                      - message
                      - requestId
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - BAD_REQUEST
                          - VALIDATION_ERROR
                          - UNAUTHORIZED
                          - FORBIDDEN
                          - NOT_FOUND
                          - CONFLICT
                          - IDEMPOTENCY_KEY_REQUIRED
                          - IDEMPOTENCY_KEY_REUSED
                          - IDEMPOTENCY_REQUEST_IN_PROGRESS
                          - APPLICATION_INACTIVE
                          - INVALID_AMOUNT
                          - UNSUPPORTED_ASSET
                          - INVALID_DESTINATION
                          - INVALID_EXPIRATION
                          - PROTOCOL_REJECTED
                          - PROTOCOL_UNAVAILABLE
                          - NO_ROUTE_AVAILABLE
                          - INSUFFICIENT_INPUT
                          - QUOTE_EXPIRED
                          - QUOTE_NOT_SELECTABLE
                          - QUOTE_NOT_LOCKED
                          - EXECUTION_NOT_FAILED
                          - EXECUTION_NOT_RESUMABLE
                          - LOGO_FORMAT_UNSUPPORTED
                          - LOGO_DIMENSIONS_INVALID
                          - LOGO_STORAGE_UNAVAILABLE
                          - ROUTE_UNAVAILABLE
                          - RATE_LIMITED
                          - INVALID_CREDENTIALS
                          - EMAIL_NOT_VERIFIED
                          - EMAIL_ALREADY_REGISTERED
                          - SESSION_EXPIRED
                          - INVALID_TOKEN
                          - INTERNAL_ERROR
                      message:
                        type: string
                      requestId:
                        type: string
                      retryable:
                        type: boolean
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            path:
                              type: string
                            message:
                              type: string
                          required:
                            - path
                            - message
                          additionalProperties: false
                    required:
                      - code
                      - message
                      - requestId
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
      security:
        - apiKey: []
      x-codeSamples:
        - lang: typescript
          label: Node.js SDK
          source: >-
            import { Useroutr } from "@useroutr/sdk";


            const useroutr = new Useroutr({ apiKey: process.env.USEROUTR_API_KEY
            });


            const quote = await useroutr.quotes.retrieve("qt_9e3c5a70");
        - lang: bash
          label: cURL
          source: >-
            curl -X GET "https://api.sandbox.useroutr.com/v1/quotes/qt_9e3c5a70"
            \
              -H "Authorization: Bearer $USEROUTR_API_KEY"
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Application API authentication for developer backends: `Authorization:
        Bearer ur_test_...` or `ur_live_...`. Resolves the application, its
        environment and the key's status. Never a dashboard login.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.