Ctrl+K

Internal list wallet IDs for a user

get/api/v2/internal/wallets/ids

Returns the auth-scoped wallet IDs visible to the calling user in the given enterprise. Deleted wallets are excluded. No balance, label, or other wallet metadata is returned — callers that need richer fields should use v2.internal.wallet.list.

Query Parameters

  • enterprisestringRequired
    The enterprise whose wallets should be resolved. Required.
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • coinstring or array
    Filter wallets by coin (chain).
    Example: btc | ['btc', 'eth']
  • typestring or array
    Filter wallets by wallet type.
  • permissionstring
    Return only wallets for which the user has the given permission. Mirrors the `permission` filter on `v2.internal.wallet.list`.
    Enum: admin view spend

200 Response

walletIds array[string] required
Example: 59cd72485007a239fb00282ed480da1f

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

401 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

403 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

500 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id