Get Wallet

Get wallet details by ID

GET /api/v1/wallets/{id}

Get wallet by ID

cURL

curl --request GET \
  --url https://api.paratro.com/api/v1/wallets/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "wallet_id": "wal_a1b2c3d4e5f6",
  "client_id": "cli_x1y2z3",
  "wallet_name": "Treasury Wallet",
  "status": "PROGRESSING",
  "key_status": "GENERATING",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:30:00Z",
  "description": "Main treasury wallet for operations."
}

Get Wallet

Retrieve details of a specific wallet.

id · string · required

Wallet ID (UUID).

Response

{
  "wallet_id": "w_01HXYZ...",
  "client_id": "c_01HXYZ...",
  "wallet_name": "My Wallet",
  "description": "",
  "status": "ACTIVE",
  "key_status": "ACTIVE",
  "created_at": "2025-01-15T10:30:45+08:00",
  "updated_at": "2025-01-15T10:30:45+08:00"
}

Errors

HTTP	Code	Condition
400	invalid_parameter	Missing wallet ID
404	not_found	Wallet not found

Authorizations

Authorization · string · header · required

JWT access token obtained from the /api/v1/auth/token endpoint.

Path Parameters

id · string · required

The unique identifier of the wallet.

Response

200

application/json

Wallet retrieved successfully.

wallet_id · string · required

Unique identifier for the wallet.

Example:

"wal_a1b2c3d4e5f6"

client_id · string · required

The client ID that owns this wallet.

Example:

"cli_x1y2z3"

wallet_name · string · required

Human-readable name for the wallet.

Example:

"Treasury Wallet"

status · string · required

Wallet lifecycle status returned by the gateway, for example PROGRESSING or ACTIVE.

Example:

"PROGRESSING"

key_status · string · required

Key lifecycle status returned by the gateway, for example GENERATING or ACTIVE.

Example:

"GENERATING"

created_at · string<date-time> · required

Timestamp when the wallet was created.

Example:

"2026-01-15T10:30:00Z"

updated_at · string<date-time> · required

Timestamp when the wallet was last updated.

Example:

"2026-01-15T10:30:00Z"

description · string | null

Optional description of the wallet.

Example:

"Main treasury wallet for operations."