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

> ## Agent Instructions
> If you are an AI assistant operating Infinite for a user, read the skill first: https://docs.infinite.dev/agent-skill.md (setup per host, tool reference, rules for moving money, journeys).
> When operating Infinite for a user, use the MCP server. Sign in at https://bot.api.infinite.dev/mcp (production, acts as the user) or send `Authorization: Bearer <key>` to https://bot.api.infinite.dev/mcp/sse. Prefer its tools over raw HTTP; use REST only for steps no tool covers, and check `get_endpoint_schema` before guessing a request shape.
> Net-new Infinite Connect (org_connect) is operator-assisted: do not grant end users shared org_connect Auth Kit membership or the shared platform org API key — those credentials are org-wide on /v1. BYO org keys onboard under that customer's org id. Operator sessions should show org_connect in get_organization_info.
> The key decides the tools. Every organization key (`sk_sandbox_…` / `sk_live_…`) gets docs, onboarding, `get_account_balance`, and request logs for your own organization. BYO organizations add payees an agent will pay with `create_payee` (payable once ACTIVE). Platform Connect sessions instead get bound-customer payment lookups (`get_quote`, `get_transfer`, `list_transfers`, `list_account_balances`), payee drafts (`create_payee_draft` / `get_payee_draft`; screening only, never payable), and transfer drafts that wait for Infinite approval (`create_transfer_draft` / `get_transfer_draft`; never POST /v1/transfers). Where offered, platform `create_transfer` files a real transfer that Infinite holds in review before funding; it cannot be submitted from DRAFT.
> An agent key (`sk_sandbox_agent_…` / `sk_live_agent_…`) moves money within that agent's limits: `create_transfer` → `submit_transfer` → `wait_for_transfer`.
> On sandbox organization-key sessions, `sandbox_approve_customer` (makes the capabilities you pass READY, and related ones may turn READY too; `request_capabilities` is not needed), `sandbox_fund_account`, and `sandbox_complete_transfer` stand in for verification, funding, and settlement, so a whole flow runs from MCP. BYO keys can pass `customerId` on each call without binding; platform sessions must bind a customer first (`create_business_customer` auto-binds, or send `X-Infinite-On-Behalf-Of`).
> When searching documentation without a key, use the docs MCP at https://docs.infinite.dev/mcp.
> Start in sandbox (https://sandbox.api.infinite.dev). Do not use production unless the user explicitly asks.
> Confirm amount, currency, and payee with the user before any payment is submitted. Pass the invoice number as `reference` on `create_transfer`; the summary says what the payee will see.
> REST amounts are integer minor units (`"4000"` = 40.00 USD). MCP payment tools take exact decimal strings (`"40.00"`). Never mix them.
> Agent denials return `403 { denial: { code, message, window, limit, used, remaining, attemptedAmount, currency }, hint }` with decimal amounts; per-transfer denials omit `used` and `remaining`. Report them to the user; do not work around them.

# Confirm a transfer quote



## OpenAPI

````yaml post /v1/transfers/quotes/{confirmationReference}/confirm
openapi: 3.0.0
info:
  title: Infinite API
  description: API for Infinite
  version: '1.0'
  contact: {}
servers:
  - url: https://sandbox.api.infinite.dev
    description: Sandbox
  - url: https://api.infinite.dev
    description: Production
security: []
tags:
  - name: Accounts
    description: Virtual and external account management
  - name: Customers
    description: Customer identity management
  - name: Documents
    description: Document upload and management
  - name: Fixed Routes
    description: Fixed route management
  - name: External Bank Accounts
    description: External bank account management
  - name: External Wallets
    description: External wallet management
  - name: Infinite Wallets
    description: Infinite Wallet management
  - name: Organizations
    description: Organization management
  - name: Quotes
    description: Quote creation and management
  - name: Transfers
    description: Money movement and transaction tracking
  - name: Verification
    description: Identity verification workflows
  - name: Terms of Service
    description: Terms of Service acceptance
  - name: Health
    description: System health and monitoring
  - name: Sandbox
    description: Sandbox utilities
paths:
  /v1/transfers/quotes/{confirmationReference}/confirm:
    post:
      tags:
        - Transfers
      summary: Confirm a transfer quote
      operationId: TransfersController_confirmIntentQuote_v1
      parameters:
        - name: X-API-Key
          in: header
          description: API key
          required: false
          schema:
            type: string
        - name: confirmationReference
          required: true
          in: path
          description: Opaque confirmation reference returned by quote creation.
          schema:
            type: string
        - name: Idempotency-Key
          required: true
          in: header
          description: Required UUID preventing duplicate confirmations.
          schema:
            type: string
      responses:
        '200':
          description: Transfer created from the quoted intent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferIntentResultResponseDto'
        '401':
          description: Unauthorized - Invalid or missing authentication credentials
      security:
        - bearer: []
      x-codeSamples:
        - lang: bash
          label: CLI
          source: >-
            # Requires: npm i -g @infinite_dev/cli && export
            INFINITE_API_KEY=sk_sandbox_...

            # Escape hatch for any endpoint: infinite api <METHOD> <path>

            infinite api POST /v1/transfers/quotes/quote_abc123/confirm \
              --header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000'
        - lang: text
          label: MCP
          source: >-
            Confirm a transfer quote (quote_abc123).


            # Infinite MCP is read-only for this endpoint — use a dedicated MCP
            tool when one exists, otherwise run the CLI tab.
components:
  schemas:
    TransferIntentResultResponseDto:
      type: object
      properties:
        transferId:
          type: string
          example: tfr_abc123
        flow:
          type: string
          description: Customer-facing transfer flow.
          example: FIAT_TO_CRYPTO
        status:
          type: string
          description: Current customer-facing transfer status.
          example: PENDING
        fundingRequired:
          type: boolean
          description: Whether customer funding is required.
          example: true
        depositInstructions:
          description: Deposit instructions when customer funding is required.
          oneOf:
            - $ref: '#/components/schemas/CryptoDepositInstructionsDto'
            - $ref: '#/components/schemas/FiatDepositInstructionsDto'
        fundingInstructions:
          description: Bank funding instructions when a wire deposit is required.
          allOf:
            - $ref: '#/components/schemas/FxTradeFundingInstructionsDto'
        fundingDeadline:
          type: string
          description: Customer funding deadline when funding is required.
          format: date-time
      required:
        - transferId
        - flow
        - status
        - fundingRequired
    CryptoDepositInstructionsDto:
      type: object
      properties:
        type:
          type: string
          description: Instruction type
          example: crypto
        paymentRail:
          type: string
          description: Payment rail (blockchain)
          example: ETHEREUM
        toAddress:
          type: string
          description: Destination wallet address
          example: '0x1234567890abcdef1234567890abcdef12345678'
        amount:
          description: Amount to deposit
          allOf:
            - $ref: '#/components/schemas/MoneyOutputDto'
        blockchainMemo:
          type: string
          description: Blockchain memo (for chains that require it)
          nullable: true
        accountId:
          type: string
          description: Account ID for the deposit destination
          example: acc_abc123
          nullable: true
      required:
        - type
        - paymentRail
        - toAddress
        - amount
    FiatDepositInstructionsDto:
      type: object
      properties:
        type:
          type: string
          description: Instruction type
          example: fiat
        paymentRail:
          type: string
          description: Payment rail
          example: ACH
        direction:
          type: string
          description: ACH direction when the funding instructions are ACH-specific
          enum:
            - CREDIT
            - DEBIT
          example: CREDIT
          nullable: true
        amount:
          description: Amount to deposit
          allOf:
            - $ref: '#/components/schemas/MoneyOutputDto'
        bankName:
          type: string
          description: Bank name
          nullable: true
        bankAddress:
          description: Bank address (structured)
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/BankAddressDto'
        accountNumber:
          type: string
          description: Account number
          nullable: true
        routingNumber:
          type: string
          description: Routing number (US)
          nullable: true
        beneficiaryName:
          type: string
          description: Beneficiary name
          nullable: true
        beneficiaryAddress:
          description: Beneficiary address (structured)
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/BankAddressDto'
        iban:
          type: string
          description: IBAN (international)
          nullable: true
        swiftBic:
          type: string
          description: SWIFT/BIC code
          nullable: true
        depositMessage:
          type: string
          description: Deposit message/reference to include in the transfer
          nullable: true
        clabe:
          type: string
          description: CLABE (Mexico)
          nullable: true
        accountId:
          type: string
          description: Account ID for the deposit destination
          example: vba_abc123
          nullable: true
      required:
        - type
        - paymentRail
        - amount
    FxTradeFundingInstructionsDto:
      type: object
      properties:
        reference:
          type: string
          description: >-
            Reference the customer must include on their outbound wire so the
            funds can be attributed to this trade. Customer-visible; renders
            verbatim in their banking app.
          example: CDX-7K2A9V
        currency:
          type: string
          description: ISO 4217.
          example: EUR
        amount:
          type: string
          description: Amount the customer must wire, in source-currency minor units.
          example: '10000'
        supportedRails:
          description: >-
            Rails accepted for the inbound wire — the customer picks one in
            their banking app and matches it to the account variant in
            `accounts` carrying the right identifiers for that rail.
          example:
            - SEPA
          type: array
          items:
            type: string
        bank:
          $ref: '#/components/schemas/FxTradeFundingInstructionsBankDto'
        accounts:
          description: >-
            One entry per rail-variant receiving account. Pick the entry
            matching the rail used to initiate the wire.
          type: array
          items:
            $ref: '#/components/schemas/FxTradeFundingInstructionsAccountDto'
        swiftRoutingBanks:
          description: >-
            Correspondent / intermediary banks required when routing via SWIFT.
            Omitted when the route has no SWIFT correspondents.
          type: array
          items:
            $ref: '#/components/schemas/FxTradeFundingInstructionsSwiftBankDto'
        expiresAt:
          type: string
          description: Wire-by deadline (ISO 8601).
          example: '2026-05-26T19:54:00.000Z'
      required:
        - reference
        - currency
        - amount
        - supportedRails
        - bank
        - accounts
        - expiresAt
    MoneyOutputDto:
      type: object
      properties:
        currency:
          type: string
          description: Currency code
          example: USD
        exponent:
          type: number
          description: >-
            Number of decimal places for this currency (e.g., 2 for USD, 6 for
            USDC)
          example: 2
        value:
          type: string
          description: Amount in smallest unit as a string
          example: '12345'
        displayValue:
          type: string
          description: Human-readable decimal value
          example: '123.45'
      required:
        - currency
        - exponent
        - value
        - displayValue
    BankAddressDto:
      type: object
      properties:
        addressLine1:
          type: string
          description: Address line 1 (optional for bank addresses)
          example: 123 Main Street
          maxLength: 1024
        addressLine2:
          type: string
          description: Address line 2 (apartment, suite, etc.)
          example: Apt 4B
          maxLength: 1024
        city:
          type: string
          description: City
          example: San Francisco
          maxLength: 256
        state:
          type: string
          description: State / Province
          example: CA
          maxLength: 256
        postalCode:
          type: string
          description: Postal code / ZIP code (optional for bank addresses)
          example: '94102'
          maxLength: 50
        country:
          type: string
          description: Country code (ISO 3166-2)
          example: US
          minLength: 2
          maxLength: 2
    FxTradeFundingInstructionsBankDto:
      type: object
      properties:
        name:
          type: string
          example: Commerzbank AG
        address:
          type: string
          example: Mainzer Landstraße 153, 60327 Frankfurt
        country:
          type: string
          description: ISO 3166-2.
          example: DE
    FxTradeFundingInstructionsAccountDto:
      type: object
      properties:
        supportedRails:
          description: >-
            Rails this account accepts inbound wires on. Pick the account whose
            rails include the one used to initiate the wire.
          example:
            - SEPA
          type: array
          items:
            type: string
        accountHolderName:
          type: string
          example: Acme Onramp Ltd
        accountNumber:
          type: string
          example: '12345678'
        iban:
          type: string
          example: DE89370400440532013000
        bic:
          type: string
          example: COBADEFFXXX
        sortCode:
          type: string
          example: 12-34-56
        routingNumber:
          type: string
          description: ABA routing number (US ACH / Fedwire).
          example: '021000021'
      required:
        - supportedRails
    FxTradeFundingInstructionsSwiftBankDto:
      type: object
      properties:
        role:
          type: string
          enum:
            - INTERMEDIARY
            - CORRESPONDENT
        bankName:
          type: string
          example: Citibank N.A.
        bic:
          type: string
          example: CITIUS33XXX
        abaRoutingNumber:
          type: string
          example: '021000089'
      required:
        - role
        - bankName
        - bic
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API Key
      type: http
      description: API Key in Bearer format (e.g., Bearer sk_test_...)

````

## Related topics

- [Quotes and Transfers](/guides/quotes-and-transfers.md)
- [Confirm an unlocked transfer intent](/api-reference/transfers/confirm-an-unlocked-transfer-intent.md)
- [Quote a transfer intent](/api-reference/transfers/quote-a-transfer-intent.md)
- [Transfers](/concepts/transfers.md)
- [Agents](/concepts/agents.md)
