Get Custody Provider

Returns one custody provider's configuration, in the same masked shape as a row of List Custody Providers. A provider that has never been saved comes back as a not-configured stub (configured: false) rather than an error. An unsupported provider key is refused.

Platform owner only. The caller's node must be the platform root node; any other caller is refused with 403 / 10005.

Required permission: custodial-wallet:view

Request

GET /v2/admin/custodial-wallets/{provider}

Parameters

Name	Type	In	Description
provider	string	path	Required. Provider key: rudiq or taurus

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/custodial-wallets/rudiq' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "provider": "rudiq",
  "host": "custody-gateway.custody.svc.cluster.local",
  "port": 8080,
  "timeout": 30,
  "is_active": true,
  "effective_active": true,
  "username_set": false,
  "password_set": false,
  "api_key_set": true,
  "api_key_last4": "7c1e",
  "configured": true,
  "webhook": {
    "auth_type": "basic",
    "path": "/v2/webhooks/custodial",
    "url": "https://integration.example.com/v2/webhooks/custodial",
    "username": "apex-custody",
    "secret_set": true
  },
  "created_at": "2026-09-02T08:14:51.120Z",
  "updated_at": "2026-10-21T13:05:09.774Z"
}

Response Fields

The fields are described on List Custody Providers.

Errors

Status	Code	Description
400	10015	Unsupported provider key
403	10005	The caller is not the platform owner (domain 2)

See Errors for the error format and common codes.