Core API
- Concepts
- Authentication
- Countries
- Users
- KYC
- Capabilities
- Terms of Service
- Files
- Assets
- Accounts
- External Accounts
- Transactions
- Webhooks
Widgets API
- Payment
Get external account
Get an external account for the user.
curl --request GET \
--url https://api.enterprise.sandbox.uphold.com/core/external-accounts/{externalAccountId} \
--header 'Authorization: Bearer <token>'{
"externalAccount": {
"id": "aa6e6efa-8d73-497c-8278-0347f459bd68",
"ownerId": "1e32fca3-23f7-40ed-bc1b-de10c790182d",
"type": "card",
"status": "ok",
"label": "My Visa Card",
"asset": "GBP",
"network": "visa",
"features": [
"deposit",
"withdraw"
],
"details": {
"type": "debit",
"last4Digits": "1519",
"expiryDate": {
"month": 12,
"year": 2030
}
},
"createdAt": "2024-06-01T00:00:00Z",
"updatedAt": "2024-07-15T00:00:00Z"
}
}Authorizations
OAuth 2.0 authentication.
Path Parameters
The external account identifier.
Response
The unique identifier of the external account.
The unique identifier of the user that owns the account.
The type of the external account.
card The status of the external account.
processing, ok, failed, restricted, blocked The label of the external account.
The asset in which the external account is denominated.
The features of the external account.
withdraw, deposit The time at which the external account was created.
The last time at which the external account was updated.
Card details.
The last 4 digits of the card number.
The type of the card, available if card was recognized.
credit, debit The details of the status of the external account.
The reason why the external account linkage failed.
card-data-invalid, card-declined-by-bank, card-expired, card-permanently-declined-by-bank, card-unauthorized, card-unsupported, velocity, unspecified-error The network that the external account corresponds to.
curl --request GET \
--url https://api.enterprise.sandbox.uphold.com/core/external-accounts/{externalAccountId} \
--header 'Authorization: Bearer <token>'{
"externalAccount": {
"id": "aa6e6efa-8d73-497c-8278-0347f459bd68",
"ownerId": "1e32fca3-23f7-40ed-bc1b-de10c790182d",
"type": "card",
"status": "ok",
"label": "My Visa Card",
"asset": "GBP",
"network": "visa",
"features": [
"deposit",
"withdraw"
],
"details": {
"type": "debit",
"last4Digits": "1519",
"expiryDate": {
"month": 12,
"year": 2030
}
},
"createdAt": "2024-06-01T00:00:00Z",
"updatedAt": "2024-07-15T00:00:00Z"
}
}