Skip to main content
GET
/
wallets
Get user wallet
curl --request GET \
  --url https://{host}/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'x-user-id: <x-user-id>'
{
  "id": "wal_64f0c51e7fb3fc001234abcd",
  "owner": "64f0c51e7fb3fc001234a001",
  "iban": "GR1601101250000000012300695",
  "status": "active",
  "createdAt": "2024-10-03T10:30:00Z",
  "updatedAt": "2024-10-05T09:15:00Z"
}
Fetch the user’s wallet to access the dedicated IBAN and current status. Pass the user identifier in the owner query parameter to retrieve the wallet that was automatically provisioned when the user account was created. The response includes the wallet’s unique IBAN and status, which indicates whether the wallet is ready to receive funds.

Authorizations

​
Authorization
string
header
required

Auth0-issued access token that includes the scopes listed for the endpoint.

Headers

​
x-user-id
string
required

The external user identifier of the acting customer.

Pattern: ^[a-f0-9]{24}$
Example:

"64f0c51e7fb3fc001234a001"

Response

Wallet retrieved successfully

​
id
string
required

Unique identifier of the wallet

Example:

"wal_64f0c51e7fb3fc001234abcd"

​
owner
string
required

Identifier of the wallet owner (user id)

Example:

"64f0c51e7fb3fc001234a001"

​
status
enum<string>
required

Current status of the wallet

Available options:
created,
delayed,
active,
deactivated,
closed
Example:

"active"

​
createdAt
string<date-time>
required

Timestamp when the wallet was created

Example:

"2024-10-03T10:30:00Z"

​
updatedAt
string<date-time>
required

Timestamp when the wallet was last updated

Example:

"2024-10-05T09:15:00Z"

​
iban
string

Dedicated IBAN assigned to the wallet

Example:

"GR1601101250000000012300695"