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

# Read the default live/current state of a quote.

> Read the default live/current quote-state view for a quote created earlier through POST /quotes. This is the primary current-state readback path; use GET /quotes/{quoteId} for retained historical detail.



## OpenAPI

````yaml /openapi/blips-public-reference.yaml get /quotes/{quoteId}/current
openapi: 3.1.0
info:
  title: BLIPS Public Reference API
  version: '2026-04-08'
  description: >-
    Public OpenAPI 3.1 subset for the first BLIPS Mintlify API Reference and
    Playground release. This document is bound to the confirmed Public Test
    Backend at https://public-test.blips.network, includes only the approved
    first-release public endpoints, uses only internal `$ref` values, and
    excludes callback-only webhook documentation and operator-only surfaces.
servers:
  - url: https://public-test.blips.network
    description: >-
      Confirmed Public Test Backend ingress target for public BLIPS API
      Reference, Playground, and internet-testable Try It flows.
security:
  - BasicAuth: []
tags:
  - name: Platform Setup
    description: >-
      Bootstrap and platform configuration surfaces for establishing the public
      BLIPS integration context.
  - name: Sandbox API
    description: >-
      Sandbox-only externally displayed helper surfaces. These routes either
      adjust quote inputs or create incoming-payment review cases, but they
      always feed the existing quote or transaction families and never become
      second outward API families.
  - name: Tokens
    description: >-
      Platform-scoped API credential create, list, detail, and revoke
      operations.
  - name: Customers
    description: >-
      Customer onboarding, profile lifecycle, and PPV payment-address issuance
      surfaces.
  - name: Accounts
    description: >-
      Customer-bound internal-account and external-account surfaces kept in the
      first-layer public contract.
  - name: Same-Currency Transfers
    description: >-
      Same-currency receiver lookup plus incoming and outgoing transfer
      primitives.
  - name: Cross-Currency Transfers
    description: >-
      PPV-first receiver lookup, quote creation/readback, and quote execution
      for cross-currency flows.
  - name: Transactions
    description: Transaction readback plus bounded incoming-review decision operations.
  - name: Webhooks
    description: >-
      Webhook connectivity verification surface for the public BLIPS
      integration.
paths:
  /quotes/{quoteId}/current:
    get:
      tags:
        - Cross-Currency Transfers
      summary: Read the default live/current state of a quote.
      description: >-
        Read the default live/current quote-state view for a quote created
        earlier through POST /quotes. This is the primary current-state readback
        path; use GET /quotes/{quoteId} for retained historical detail.
      operationId: getQuoteCurrent
      parameters:
        - $ref: '#/components/parameters/QuoteId'
      responses:
        '200':
          description: Live current quote state returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteCurrentResponse'
              examples:
                current:
                  value:
                    quoteId: Quote:quote_current_01
                    transactionId: txn_quote_current_001
                    createdAt: '2026-04-05T12:00:00Z'
                    expiresAt: '2026-04-05T12:05:00Z'
                    lockedCurrencySide: SENDING
                    lockedCurrencyAmount: '100000'
                    sendingAmount:
                      currencyCode: SGD
                      amountMinor: '100000'
                    receivingAmount:
                      currencyCode: PHP
                      amountMinor: '4200000'
                    feesTotal:
                      currencyCode: SGD
                      amountMinor: '500'
                    exchangeRate: 42
                    feesIncluded: true
                    status: PROCESSING
                    freshness:
                      status: FRESH
                      evaluatedAt: '2026-04-05T12:01:00Z'
                    outgoingTransaction:
                      transactionId: txn_quote_current_out_001
                      status: PROCESSING
                      settledAt: null
                    incomingTransaction:
                      transactionId: txn_quote_current_in_001
                      status: PENDING
                      settledAt: null
        '400':
          description: Invalid quoteId path value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteCurrentMvpErrorResponse'
              examples:
                invalidRequest:
                  value:
                    status: 400
                    code: INVALID_REQUEST
                    message: Invalid quoteId path value
                    details:
                      quoteId: must be a non-empty quote identifier
        '401':
          description: Invalid or missing API credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteCurrentMvpErrorResponse'
              examples:
                unauthorized:
                  value:
                    status: 401
                    code: UNAUTHORIZED
                    message: Invalid or missing API credentials
                    details: {}
        '404':
          description: Quote not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteCurrentMvpErrorResponse'
              examples:
                quoteNotFound:
                  value:
                    status: 404
                    code: QUOTE_NOT_FOUND
                    message: Quote not found
                    details: {}
        '500':
          description: Internal service error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteCurrentMvpErrorResponse'
              examples:
                internalError:
                  value:
                    status: 500
                    code: INTERNAL_ERROR
                    message: Internal service error
                    details: {}
      security:
        - BasicAuth: []
components:
  parameters:
    QuoteId:
      name: quoteId
      in: path
      required: true
      schema:
        type: string
      description: >-
        Quote identifier returned by quote creation and other quote read/list
        flows. Use it to read the current state of an existing quote.
  schemas:
    QuoteCurrentResponse:
      type: object
      description: >-
        Primary live/current quote-state read model returned by GET
        /quotes/{quoteId}/current.
      properties:
        quoteId:
          type: string
          description: Stable BLIPS quote identifier for this quote.
        transactionId:
          type: string
          description: Public transaction identifier linked to this quote state.
        createdAt:
          type: string
          format: date-time
          description: RFC 3339 timestamp when this quote was created.
        expiresAt:
          type: string
          format: date-time
          description: RFC 3339 timestamp when this quote expires.
        lockedCurrencySide:
          type: string
          enum:
            - SENDING
            - RECEIVING
          description: Which side of the quote amount is locked.
        lockedCurrencyAmount:
          type: string
          pattern: ^[0-9]+$
          description: Locked amount in minor units on the selected locked currency side.
        sendingAmount:
          $ref: '#/components/schemas/MoneyAmount'
          description: Current sender-side amount for this quote.
        receivingAmount:
          $ref: '#/components/schemas/MoneyAmount'
          description: Current receiver-side amount for this quote.
        feesTotal:
          $ref: '#/components/schemas/MoneyAmount'
          description: Current total fees for this quote.
        exchangeRate:
          type: number
          description: Current quoted exchange rate.
        feesIncluded:
          type: boolean
          description: Whether the current quote amounts already include fees.
        status:
          type: string
          description: Status of this quote in the live/current read model.
        freshness:
          type: object
          description: Optional freshness evaluation for this live/current quote view.
          properties:
            status:
              type: string
              description: Freshness state for this live/current quote view.
            evaluatedAt:
              type: string
              format: date-time
              description: When freshness was last evaluated.
          required:
            - status
          additionalProperties: false
        outgoingTransaction:
          type: object
          description: >-
            Bounded linked outgoing transaction snapshot once execution has
            started.
          properties:
            transactionId:
              type: string
              description: Linked outgoing transaction identifier.
            status:
              type: string
              description: Current stored status of the linked outgoing transaction.
            settledAt:
              type:
                - string
                - 'null'
              format: date-time
              description: >-
                Settlement timestamp when the linked outgoing transaction has
                settled.
          required:
            - transactionId
            - status
          additionalProperties: false
        incomingTransaction:
          type: object
          description: >-
            Bounded linked incoming transaction snapshot once execution has
            started.
          properties:
            transactionId:
              type: string
              description: Linked incoming transaction identifier.
            status:
              type: string
              description: Current stored status of the linked incoming transaction.
            settledAt:
              type:
                - string
                - 'null'
              format: date-time
              description: >-
                Settlement timestamp when the linked incoming transaction has
                settled.
          required:
            - transactionId
            - status
          additionalProperties: false
      required:
        - quoteId
        - transactionId
        - createdAt
        - expiresAt
        - lockedCurrencySide
        - lockedCurrencyAmount
        - sendingAmount
        - receivingAmount
        - feesTotal
        - exchangeRate
        - feesIncluded
        - status
      additionalProperties: false
    QuoteCurrentMvpErrorResponse:
      type: object
      description: >-
        Standard public error envelope for live/current quote-state readback
        failures.
      additionalProperties: false
      required:
        - status
        - code
        - message
        - details
      properties:
        status:
          type: integer
          description: HTTP status code returned for the failed current-quote request.
        code:
          type: string
          description: Stable public error code for the failed current-quote request.
        message:
          type: string
          description: Human-readable summary of the current-quote failure.
        details:
          type: object
          nullable: true
          additionalProperties: true
          description: Additional structured error context when present.
    MoneyAmount:
      type: object
      properties:
        currencyCode:
          type: string
          description: ISO 4217 currency code.
        amountMinor:
          type: string
          description: Amount in minor units for that currency.
      required:
        - currencyCode
        - amountMinor
      additionalProperties: false
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
      description: >-
        Integration-key Basic Auth (`clientId:clientSecret`) as documented in
        docs/public/AUTHENTICATION.md.

````