> ## 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. # Get wallet > This operation retrieves detailed information about a specific wallet by its ID. The wallet ID can be retrieved by calling the List all wallets operation. When the caller is the wallet owner, the response includes a `spend_summary` array showing spending totals per delegation. ## OpenAPI ````yaml get /api/v1/wallets/{wallet_uuid} 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/{wallet_uuid}: get: tags: - Wallets summary: Get wallet description: >- This operation retrieves detailed information about a specific wallet by its ID. The wallet ID can be retrieved by calling the List all wallets operation. When the caller is the wallet owner, the response includes a `spend_summary` array showing spending totals per delegation. operationId: get_wallet parameters: - name: wallet_uuid in: path required: true schema: type: string format: uuid title: Wallet Uuid - name: include_spend_summary in: query required: false schema: type: boolean description: >- Whether to include per-delegation spending summaries in the response. Only populated when the authenticated principal is the wallet owner. `true`: include spend summaries. `false`: omit spend summaries. default: false title: Include Spend Summary description: >- Whether to include per-delegation spending summaries in the response. Only populated when the authenticated principal is the wallet owner. `true`: include spend summaries. `false`: omit spend summaries. - 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_WalletDetailRead_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/WrappedValidationError' components: schemas: StandardResponse_WalletDetailRead_: properties: success: type: boolean title: Success default: true result: $ref: '#/components/schemas/WalletDetailRead' 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[WalletDetailRead] 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' WalletDetailRead: 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 spend_summary: items: $ref: '#/components/schemas/DelegationSpendSummary' type: array title: Spend Summary groups: items: $ref: '#/components/schemas/WalletGroupRead' type: array title: Groups description: >- Key share holder groups and nodes for MPC-UCW wallets (empty for non-MPC). type: object required: - uuid - wallet_type - name - owner_id - cobo_wallet_id - status - metadata - created_at - updated_at title: WalletDetailRead 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. DelegationSpendSummary: properties: delegation_id: type: string format: uuid title: Delegation Id description: The delegation ID. operator_id: type: string format: uuid title: Operator Id description: The operator's principal ID. frozen: type: boolean title: Frozen description: >- Whether the delegation is currently frozen. `true`: frozen. `false`: active. daily_spent: type: string title: Daily Spent description: >- The total amount spent today by this delegation, as a decimal string. daily_limit: title: Daily Limit description: >- The daily spending limit for this delegation. Null if no daily limit is set. type: string nullable: true monthly_spent: type: string title: Monthly Spent description: >- The total amount spent this month by this delegation, as a decimal string. monthly_limit: title: Monthly Limit description: >- The monthly spending limit for this delegation. Null if no monthly limit is set. type: string nullable: true usage_limits_summary: items: $ref: '#/components/schemas/DelegationUsageLimitSummary' type: array title: Usage Limits Summary description: >- Per-window usage limit snapshots for delegation policies, including used/limit/remaining. type: object required: - delegation_id - operator_id - frozen - daily_spent - monthly_spent title: DelegationSpendSummary WalletGroupRead: properties: group_id: type: string title: Group Id description: Cobo group id. group_type: $ref: '#/components/schemas/KeyShareHolderGroupType' description: >- WaaS KeyShareHolderGroupType: MainGroup, SigningGroup, RecoveryGroup. holder_role: $ref: '#/components/schemas/VaultGroupType' description: 'MPC user-side holder: `agent` (CLI/server) or `human` (mobile).' group_status: $ref: '#/components/schemas/KeyShareHolderGroupStatus' description: 'WaaS KeyShareHolderGroupStatus: New, Valid, Unavailable.' nodes: items: $ref: '#/components/schemas/WalletGroupNodeRead' type: array title: Nodes type: object required: - group_id - group_type - holder_role - group_status title: WalletGroupRead description: Cached key share holder group for an MPC wallet. DelegationUsageLimitSummary: properties: operation_type: type: string title: Operation Type description: >- Operation type for this limit, for example `transfer` or `contract_call`. window: type: string title: Window description: >- Rolling window key in counter terms, for example `hourly` or `daily`. metric: type: string title: Metric description: >- Metric dimension for this limit, for example `count`, `value`, or `usd_value`. used: type: string title: Used description: Current usage in this window, as a decimal string. limit: type: string title: Limit description: Configured threshold value, as a decimal string. remaining: type: string title: Remaining description: Remaining available quota in this window, as a decimal string. type: object required: - operation_type - window - metric - used - limit - remaining title: DelegationUsageLimitSummary KeyShareHolderGroupType: type: string enum: - MainGroup - SigningGroup - RecoveryGroup title: KeyShareHolderGroupType description: >- Aligned with ``cobo_waas2.models.key_share_holder_group_type.KeyShareHolderGroupType``. VaultGroupType: type: string enum: - agent - human title: VaultGroupType description: |- MPC Vault Group 类型 均为 2/2 配置 (User 1 片 + Cobo 1 片)。 AGENT: Agent 持有密钥分片，用于服务端自动签名（CLI 发起） HUMAN: Human 持有密钥分片，用于 UCW 移动端签名（Mobile App 发起） 当 Agent 钱包被 Human 认领后，同一个 Wallet 会同时拥有 AGENT 和 HUMAN 两个 VaultGroup，分别对应不同的签名参与方。 KeyShareHolderGroupStatus: type: string enum: - New - Valid - Unavailable title: KeyShareHolderGroupStatus description: >- Aligned with ``cobo_waas2.models.key_share_holder_group_status.KeyShareHolderGroupStatus``. WalletGroupNodeRead: properties: node_id: type: string title: Node Id description: TSS node id (WaaS). node_type: $ref: '#/components/schemas/KeyShareHolderType' description: 'WaaS KeyShareHolderType: Cobo, Mobile, API.' node_owner: title: Node Owner description: >- Display name or account id when available; null for Cobo-operated nodes. type: string nullable: true type: object required: - node_id - node_type title: WalletGroupNodeRead description: One TSS node in a key share holder group. KeyShareHolderType: type: string enum: - Cobo - Mobile - API title: KeyShareHolderType description: >- Aligned with ``cobo_waas2.models.key_share_holder_type.KeyShareHolderType``. ````