Wallet endpoint
Read statistics for the authenticated merchant wallet.
GET /wallets/me/stats requires the explicit wallet:read scope when called with a merchant API token.
Request
Read statistics for the authenticated merchant wallet. The path is relative to the global /api/v1 prefix.
Authorization
wallet:readRead merchant wallet information, transactions, statistics, and exports.
Interactive JWT requests bypass API-token scope metadata, but continue through the normal role, merchant, and permission guards. API tokens are denied on routes without an explicit token policy.
Parameters & body
This route has no path parameters in the published merchant-token contract.
Query parameters are not specified by API.md. Use the feature service contract for filters, pagination, or export options.
Examples
Replace each :parameter segment and provide a server-side environment variable for the bearer credential.
cURL
curl -X GET 'https://api.usevouchify.com/api/v1/wallets/me/stats' \
-H "Authorization: Bearer $VOUCHIFY_TOKEN"JavaScript
const response = await fetch(
'https://api.usevouchify.com/api/v1/wallets/me/stats',
{
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.VOUCHIFY_TOKEN}`
}
}
);
if (!response.ok) {
throw new Error(`Vouchify request failed: ${response.status}`);
}
const contentType = response.headers.get('content-type') || '';
const responseBody = await response.text();
const result = responseBody && contentType.includes('application/json')
? JSON.parse(responseBody)
: responseBody || null;Response contract
API.md states that response bodies are produced by existing feature services; their resource-specific schemas are authoritative. The merchant-token document does not publish a stable success schema or feature-specific error list for this route.
Authentication errors
401 for invalid/inactive credentials; 403 for missing scopes, blocked routes, or inactive merchant state.
Feature errors
Validation, not-found, and conflict errors are owned by the underlying feature service and are not enumerated in API.md.