Skip to main content
GET
/
api
/
v1
/
business
/
wallet
Wallet
curl --request GET \
  --url https://api-stage.ugift.me/api/v1/business/wallet \
  --header 'X-API-Key: <api-key>'
[
  {
    "_id": "65c2e3f4a5b6c78901234567",
    "userID": "507f1f77bcf86cd799439011",
    "currency": "GBP",
    "balance": 2000,
    "transactions": [
      {
        "transactionType": "funding",
        "transactionValue": 5000,
        "timestamp": "2024-01-10T09:00:00.000Z",
        "details": {
          "type": "single",
          "description": "Wallet top-up"
        }
      },
      {
        "transactionType": "purchase",
        "transactionValue": 50,
        "timestamp": "2025-04-12T14:22:10.000Z",
        "orderID": "65b0d1e2f3a4b56789012345",
        "details": {
          "type": "single",
          "currency": "GBP"
        }
      }
    ],
    "createdAt": "2024-01-10T09:00:00.000Z",
    "updatedAt": "2025-04-12T14:22:10.000Z"
  }
]

Authorizations

​
X-API-Key
string
header
required

Your UGiftMe API key for authentication.

Format: Secure API key (e.g., <your-api-key>)

Required: All endpoints require this header

Example: X-API-Key: <your-api-key>

Response

Wallets for the account (array of wallet documents)

​
_id
string
Example:

"65c2e3f4a5b6c78901234567"

​
userID
string
Example:

"507f1f77bcf86cd799439011"

​
currency
string
Example:

"GBP"

​
balance
number
Example:

2000

​
transactions
object[]
​
createdAt
string<date-time>
Example:

"2024-01-10T09:00:00.000Z"

​
updatedAt
string<date-time>
Example:

"2025-04-12T14:22:10.000Z"