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

# Cancel reserved funds

> Cancels a `funds_reserved` transfer and releases the reserved amount back to available credit.

The transfer must be in `funds_reserved` status for this operation.

**Note:** This endpoint is only available for Settlement Advance products.




## OpenAPI

````yaml openapi/credit.yaml put /v1/credit/transfers/{id}/cancelReserve
openapi: 3.0.2
info:
  version: ${version}
  title: Credit API
  description: >
    The Circle Credit API provides access to credit facilities including Line of
    Credit and Settlement Advance products.


    **Line of Credit** enables direct drawdowns with auto-approval and
    asynchronous disbursement. Supports both fiat and crypto repayment.


    **Settlement Advance** requires a reserve-then-request flow with manual
    approval. Requires wire proof upload for disbursement approval. Supports
    fiat repayment only.
servers:
  - url: https://api-sandbox.circle.com
  - url: https://api.circle.com
security: []
tags:
  - name: Credit
    description: Get credit line details.
  - name: Credit Transfers
    description: Create, reserve, and manage credit transfers (drawdowns).
  - name: Credit Fees
    description: View fees charged on credit transfers.
  - name: Credit Repayments
    description: View and initiate repayments on credit transfers.
paths:
  /v1/credit/transfers/{id}/cancelReserve:
    put:
      tags:
        - Credit Transfers
      summary: Cancel reserved funds
      description: >
        Cancels a `funds_reserved` transfer and releases the reserved amount
        back to available credit.


        The transfer must be in `funds_reserved` status for this operation.


        **Note:** This endpoint is only available for Settlement Advance
        products.
      operationId: cancelCreditTransferReserve
      parameters:
        - $ref: '#/components/parameters/IdPath'
      responses:
        '200':
          description: Successfully canceled the reserved funds.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                title: CancelCreditTransferReserveResponse
                properties:
                  data:
                    $ref: '#/components/schemas/CreditTransfer'
              example:
                data:
                  id: fc988ed5-c129-4f70-a064-e5beb7eb8e32
                  amount:
                    amount: '100000.00'
                    currency: USD
                  status: canceled
                  createDate: '2024-03-20T14:30:00.000Z'
                  updateDate: '2024-03-20T14:50:00.000Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/NotAuthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - bearerAuth: []
components:
  parameters:
    IdPath:
      name: id
      description: Universally unique identifier (UUID v4) of a resource.
      in: path
      required: true
      schema:
        type: string
        format: uuid
        example: b3d9d2d5-4c12-4946-a09d-953e82fae2b0
  headers:
    XRequestId:
      description: >-
        Universally unique identifier (UUID v4) for the request. Helpful for
        identifying a request when communicating with Circle support.
      schema:
        type: string
        format: uuid
        example: 2adba88e-9d63-44bc-b975-9b6ae3440dde
  schemas:
    CreditTransfer:
      type: object
      description: A credit transfer (drawdown) from the credit line.
      required:
        - id
        - amount
        - status
        - createDate
        - updateDate
      properties:
        id:
          description: Unique identifier of the transfer.
          type: string
          format: uuid
          example: b3d9d2d5-4c12-4946-a09d-953e82fae2b0
        amount:
          $ref: '#/components/schemas/FiatMoneyUsd'
          description: The transfer amount.
        status:
          description: Current status of the transfer.
          type: string
          enum:
            - funds_reserved
            - expired
            - canceled
            - requested
            - rejected
            - disbursed
            - paid
            - past_due
          example: disbursed
        outstanding:
          $ref: '#/components/schemas/FiatMoneyUsd'
          description: >-
            Remaining outstanding balance on the transfer. Present only when
            status is disbursed, paid, or past_due.
        fees:
          $ref: '#/components/schemas/CreditTransferFees'
          description: >-
            Fee summary for the transfer. Present only when status is disbursed,
            paid, or past_due.
        expiresAt:
          $ref: '#/components/schemas/UtcTimestamp'
          description: >-
            ISO-8601 UTC date/time when the reserved funds expire. Present only
            when status is funds_reserved.
        dueDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: >-
            ISO-8601 UTC date/time when the transfer repayment is due. Present
            only when status is disbursed, paid, or past_due.
        disbursedDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: >-
            ISO-8601 UTC date/time when the transfer was disbursed. Present only
            when status is disbursed, paid, or past_due.
        paidDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: >-
            ISO-8601 UTC date/time when the transfer was fully repaid. Present
            only when status is paid.
        blockchainDestination:
          $ref: '#/components/schemas/BlockchainDestinationResponse'
          description: >-
            Blockchain destination details. Present when the transfer was
            requested with a blockchain destination.
        createDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: ISO-8601 UTC date/time when the transfer was created.
        updateDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: ISO-8601 UTC date/time when the transfer was last updated.
    FiatMoneyUsd:
      type: object
      required:
        - amount
        - currency
      properties:
        amount:
          description: Magnitude of the amount, in units of the currency, with a `.`.
          type: string
          example: '3.14'
        currency:
          description: Currency code.
          type: string
          enum:
            - USD
    CreditTransferFees:
      type: object
      description: Fee summary for a credit transfer.
      required:
        - total
        - unpaid
      properties:
        total:
          $ref: '#/components/schemas/FiatMoneyUsd'
          description: Total fees accrued on the transfer.
        unpaid:
          $ref: '#/components/schemas/FiatMoneyUsd'
          description: Fees that have not yet been paid.
    UtcTimestamp:
      type: string
      description: ISO-8601 UTC date/time format.
      example: '2020-04-10T02:13:30.000Z'
    BlockchainDestinationResponse:
      type: object
      description: >-
        Blockchain destination details for a credit transfer. Present when the
        transfer was requested with a blockchain destination.
      required:
        - addressId
        - status
      properties:
        addressId:
          description: The identifier of the verified blockchain address.
          type: string
          format: uuid
          example: b3d9d2d5-4c12-4946-a09d-953e82fae2b0
        status:
          description: The status of the blockchain transfer.
          type: string
          enum:
            - pending
            - initiated
            - complete
            - failed
          example: pending
        transferId:
          description: >-
            The identifier of the blockchain transfer. Present once the transfer
            has been initiated.
          type: string
          format: uuid
          example: fc988ed5-c129-4f70-a064-e5beb7eb8e32
  responses:
    BadRequest:
      description: The request cannot be processed due to a client error.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: BadRequest
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 400
              message: Bad request.
          examples:
            response:
              value:
                code: 400
                message: Bad request.
    NotAuthorized:
      description: >-
        The request has not been applied because it lacks valid authentication
        credentials.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: NotAuthorized
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 401
              message: Malformed authorization.
          examples:
            response:
              value:
                code: 401
                message: Malformed authorization.
    NotFound:
      description: The specified resource was not found.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: NotFound
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 404
              message: Not found.
          examples:
            response:
              value:
                code: 404
                message: Not found.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````