Skip to content

Get a wallet

GET
/v1/wallets/{wallet_id}
curl --request GET \
--url https://api.feitpay.com/v1/wallets/example \
--header 'Authorization: Bearer <token>'
wallet_id
required
string
FeitPay-Organization
string

Active organization for dashboard sessions. Ignored for API keys (the key determines the organization).

Wallet.

Media typeapplication/json
object
id
required
string
object
required
string
Allowed value: wallet
livemode
required
boolean
store_id
required
string
network_id
required
string
label
required
string
mode
required
string
Allowed values: simulated xpub
address_type
required
string
Allowed values: p2wpkh evm tron simulated
xpub_fingerprint
required
string | null
derivation_template
required
string | null
status
required
string
Allowed values: active disabled
next_index
required
integer
gap_limit
required
integer
last_used_index
required
integer | null
ownership
required
object
status
required
string
Allowed values: unverified pending verified failed expired sandbox_fixture
verified_at
required
string | null format: date-time
created_at
required
string format: date-time

Example

{
"object": "wallet",
"mode": "simulated",
"address_type": "p2wpkh",
"status": "active",
"ownership": {
"status": "unverified"
}
}

Missing or invalid credentials.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Authenticated but not permitted.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Resource not found (or not visible to this tenant).

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Too many requests. See Retry-After.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}
Retry-After
integer