> ## Documentation Index > Fetch the complete documentation index at: https://cobo.com/products/agentic-wallet/manual/llms.txt > Use this file to discover all available pages before exploring further. # List all wallets > This operation retrieves all wallets accessible to the authenticated principal. Use cursor-based pagination with `after`/`before`, or the deprecated `offset` parameter. ## OpenAPI ````yaml get /api/v1/wallets openapi: 3.1.0 info: title: Cobo Agentic Wallet Service description: Unified wallet engine for human and agent principals version: 1.3.0 servers: [] security: [] paths: /api/v1/wallets: get: tags: - Wallets summary: List all wallets description: >- This operation retrieves all wallets accessible to the authenticated principal. Use cursor-based pagination with `after`/`before`, or the deprecated `offset` parameter. operationId: list_wallets parameters: - name: after in: query required: false schema: description: >- A cursor for forward pagination. Pass the `after` value from a previous response to retrieve the next page. title: After type: string nullable: true description: >- A cursor for forward pagination. Pass the `after` value from a previous response to retrieve the next page. - name: before in: query required: false schema: description: >- A cursor for backward pagination. Pass the `before` value from a previous response to retrieve the preceding page. title: Before type: string nullable: true description: >- A cursor for backward pagination. Pass the `before` value from a previous response to retrieve the preceding page. - name: offset in: query required: false schema: description: >- Deprecated. Use `after`/`before` cursors instead. The number of items to skip before returning results. deprecated: true title: Offset type: integer maximum: 9223372036854776000 minimum: 0 nullable: true description: >- Deprecated. Use `after`/`before` cursors instead. The number of items to skip before returning results. deprecated: true - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: 'The maximum number of items to return. Range: [1, 200].' default: 50 title: Limit description: 'The maximum number of items to return. Range: [1, 200].' - name: include_archived in: query required: false schema: type: boolean description: >- Whether to include archived wallets in the results. `true`: include archived wallets. `false`: exclude archived wallets. Defaults to `false`. default: false title: Include Archived description: >- Whether to include archived wallets in the results. `true`: include archived wallets. `false`: exclude archived wallets. Defaults to `false`. - name: main_node_id in: query required: false schema: description: >- Filter wallets by the TSS main node ID of their underlying vault. When set, only wallets whose vault's `main_node_id` matches this value are returned. Useful for finding all wallets controlled by a specific TSS node. title: Main Node Id type: string nullable: true description: >- Filter wallets by the TSS main node ID of their underlying vault. When set, only wallets whose vault's `main_node_id` matches this value are returned. Useful for finding all wallets controlled by a specific TSS node. - name: X-API-Key in: header required: false schema: title: X-Api-Key type: string nullable: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/StandardResponse_list_WalletRead__' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/WrappedValidationError' components: schemas: StandardResponse_list_WalletRead__: properties: success: type: boolean title: Success default: true result: items: $ref: '#/components/schemas/WalletRead' type: array title: Result suggestion: type: string title: Suggestion default: '' message: type: string title: Message default: '' meta: $ref: '#/components/schemas/PaginationMeta' nullable: true type: object required: - result title: StandardResponse[list[WalletRead]] WrappedValidationError: title: WrappedValidationError type: object required: - success - error properties: success: type: boolean const: false default: false title: Success error: type: object title: Error required: - detail properties: detail: type: array title: Detail items: $ref: '#/components/schemas/ValidationError' WalletRead: properties: uuid: type: string format: uuid title: Uuid description: The wallet ID. wallet_type: $ref: '#/components/schemas/WalletType' description: The wallet type (for example, `MPC`). name: type: string title: Name description: The wallet name. owner_id: type: string format: uuid title: Owner Id description: The ID of the principal that owns this wallet. cobo_wallet_id: title: Cobo Wallet Id description: The wallet ID assigned by Cobo WaaS. type: string nullable: true status: $ref: '#/components/schemas/WalletStatus' description: >- The wallet status. Possible values: `preparing`, `active`, `archived`. metadata: additionalProperties: true type: object title: Metadata description: Arbitrary key-value metadata associated with the wallet. created_at: type: string format: date-time title: Created At description: The timestamp when the wallet was created, in ISO 8601 format. updated_at: type: string format: date-time title: Updated At description: The timestamp when the wallet was last updated, in ISO 8601 format. main_node_id: title: Main Node Id description: >- TSS node ID of the wallet owner's main device. Only set for MPC wallets. type: string nullable: true type: object required: - uuid - wallet_type - name - owner_id - cobo_wallet_id - status - metadata - created_at - updated_at title: WalletRead description: Wallet response payload. PaginationMeta: properties: total: title: Total type: integer nullable: true offset: title: Offset type: integer nullable: true limit: title: Limit type: integer nullable: true has_more: title: Has More type: boolean nullable: true after: title: After type: string nullable: true before: title: Before type: string nullable: true type: object title: PaginationMeta description: |- Pagination metadata for list responses. Supports both legacy offset-based and cursor-based pagination. Cursor fields (``has_more``, ``after``, ``before``) are populated for cursor-paginated endpoints. Legacy fields (``offset``, ``limit``) are populated when the caller uses the deprecated ``offset`` parameter. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError WalletType: type: string enum: - Custodial - MPC title: WalletType description: Supported wallet types. WalletStatus: type: string enum: - preparing - active - archived title: WalletStatus description: Supported wallet statuses. ````