> ## 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.

# Get the wallet

> Returns the wallet as a single-element array.




## OpenAPI

````yaml openapi/digital-asset-backed-borrowing.yaml get /v1/borrow/wallets
openapi: 3.0.2
info:
  version: ${version}
  title: Digital Asset-Backed Borrowing API
  description: >
    The Digital Asset-Backed Borrowing API lets you borrow stablecoin liquidity
    against onchain collateral. It uses a dedicated wallet to hold collateral
    and borrowed funds, and Circle handles the onchain transactions. Write
    operations are asynchronous and return a job that can be polled for status.
servers:
  - url: https://api-sandbox.circle.com
  - url: https://api.circle.com
security: []
tags:
  - name: Borrow Wallets
    description: >-
      Provision and inspect the per-entity MSCA wallet that holds collateral and
      borrowed funds.
  - name: Borrow Loans
    description: Originate, inspect, repay, and add collateral to borrow positions.
  - name: Borrow Jobs
    description: Observe asynchronous onchain operations.
  - name: Borrow Markets
    description: Discover allowlisted lending markets.
paths:
  /v1/borrow/wallets:
    get:
      tags:
        - Borrow Wallets
      summary: Get the wallet
      description: |
        Returns the wallet as a single-element array.
      operationId: listBorrowWallets
      responses:
        '200':
          description: Successfully retrieved the wallet.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                title: ListBorrowWalletsResponse
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/OnchainWallet'
              examples:
                response:
                  value:
                    data:
                      - id: 9c1b2a3d-4e5f-6071-8293-a4b5c6d7e8f9
                        walletAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f9f68C'
                        owners:
                          - id: 1f2e3d4c-5b6a-7980-1234-56789abcdef0
                            userId: 2a3b4c5d-6e7f-8091-2345-6789abcdef01
                            ownerType: passkey
                            publicKey: >-
                              0x04b0a1c2d3e4f5061728394a5b6c7d8e9f00112233445566778899aabbccddeeff
                            credentialId: a1b2c3d4e5f60718
                            status: active
                            addedDate: '2026-06-20T14:10:00.000Z'
                        depositAddresses:
                          USDC: '0x5a0b4a11d3f9b2c1e8a7d6c5b4a39281f0e1d2c3'
                          cirBTC: '0xbb81dcaf9e7a6b5c4d3e2f1908172635445362718'
                        createDate: '2026-06-20T14:10:00.000Z'
        '401':
          $ref: '#/components/responses/NotAuthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      security:
        - bearerAuth: []
components:
  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:
    OnchainWallet:
      type: object
      description: >
        A modular smart contract account (MSCA) that custodies your collateral
        and

        holds your borrowed funds. You can have only one wallet.
      required:
        - id
        - walletAddress
        - owners
        - depositAddresses
        - createDate
      properties:
        id:
          type: string
          format: uuid
          description: Identifier of the wallet.
        walletAddress:
          type: string
          description: The onchain MSCA address.
          example: '0x742d35Cc6634C0532925a3b844Bc9e7595f9f68C'
        owners:
          type: array
          description: Owners currently authorized to sign transactions on this wallet.
          minItems: 1
          items:
            $ref: '#/components/schemas/OnchainWalletOwner'
        depositAddresses:
          $ref: '#/components/schemas/DepositAddresses'
        createDate:
          type: string
          format: date-time
          description: Date and time when the wallet was created.
      example:
        id: 9c1b2a3d-4e5f-6071-8293-a4b5c6d7e8f9
        walletAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f9f68C'
        owners:
          - id: 1f2e3d4c-5b6a-7980-1234-56789abcdef0
            userId: 2a3b4c5d-6e7f-8091-2345-6789abcdef01
            ownerType: passkey
            publicKey: >-
              0x04b0a1c2d3e4f5061728394a5b6c7d8e9f00112233445566778899aabbccddeeff
            credentialId: a1b2c3d4e5f60718
            status: active
            addedDate: '2026-06-20T14:10:00.000Z'
        depositAddresses:
          USDC: '0x5a0b4a11d3f9b2c1e8a7d6c5b4a39281f0e1d2c3'
          cirBTC: '0xbb81dcaf9e7a6b5c4d3e2f1908172635445362718'
        createDate: '2026-06-20T14:10:00.000Z'
    OnchainWalletOwner:
      type: object
      description: |
        An authorized signer on the wallet. A wallet has a single active owner.
      required:
        - id
        - ownerType
        - publicKey
        - status
        - addedDate
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of this owner record.
        userId:
          type: string
          format: uuid
          description: >
            Identifier of the Mint user linked to this owner. Omitted for owners
            not

            linked to any Mint user (for example, API-key onboarding).
        ownerType:
          type: string
          enum:
            - ecdsa
            - passkey
          description: >
            Signing material type. `passkey` is a WebAuthn P256 credential;
            `ecdsa` is a

            20-byte EOA address.
        publicKey:
          type: string
          description: >
            Hex-encoded signing material. For `passkey` owners this is the raw
            P256 public key

            bytes; for `ecdsa` owners this is the 20-byte EOA address.
          example: 0x04b0...
        credentialId:
          type: string
          description: >
            Hex-encoded WebAuthn credential identifier captured at passkey
            registration. Used to

            populate `allowCredentials` so the authenticator selects the right
            passkey. Omitted for

            `ecdsa` owners.
        status:
          type: string
          enum:
            - active
            - pending
            - removed
          description: >
            Lifecycle state of this owner record. `active` owners can sign.
            `pending`

            owners are being added. `removed` owners have been revoked and are

            retained for audit.
        addedDate:
          type: string
          format: date-time
          description: Date and time when this owner was added to the wallet.
      example:
        id: 1f2e3d4c-5b6a-7980-1234-56789abcdef0
        userId: 2a3b4c5d-6e7f-8091-2345-6789abcdef01
        ownerType: passkey
        publicKey: '0x04b0a1c2d3e4f5061728394a5b6c7d8e9f00112233445566778899aabbccddeeff'
        credentialId: a1b2c3d4e5f60718
        status: active
        addedDate: '2026-06-20T14:10:00.000Z'
    DepositAddresses:
      type: object
      description: >
        Deposit addresses for routing inbound transfers to the wallet. Each key
        is

        an asset symbol (such as `USDC` or `cirBTC`) and each value is a 20-byte
        EVM

        address. Addresses are provisioned when the wallet is created and
        immutable

        thereafter.
      additionalProperties:
        type: string
      example:
        USDC: 0x5a0b4a11d3f...
        cirBTC: 0xbb81dcaf9e...
  responses:
    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.
    Forbidden:
      description: >-
        The request provides authentication, but the authenticated user does not
        possess sufficient permissions for accessing this resource.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: Forbidden
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 3
              message: Forbidden
          examples:
            response:
              value:
                code: 3
                message: Forbidden
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````