Credits / Wallet

Read-only (GET) endpoints for the authenticated user's credit balance. They are free (they don't consume credit) and available with your Bearer token — no configured origin whitelist is required.

Auth: Authorization: Bearer <api_token> header on every call. Base URL: https://api.dokicasa.it (production) · https://api-dev.dokicasa.it (sandbox).

Wallet balance

GET /api/users/me/wallet

Returns the user's balance, including expected future costs (scheduled jobs and pending censimenti).

{
  "wallet": 120.00,
  "real_wallet": 89.50
}

Field	Type	Notes
wallet	number	Current nominal wallet balance
real_wallet	number	Actually spendable balance, net of already-committed (pending) costs

Transactions history

GET /api/users/me/wallet-transactions

Paginated history of wallet movements (most recent first).

Query	Default	Notes
per_page	20	items per page
page	1	page to read

Response: Laravel paginator — { current_page, data: [ … ], per_page, total, last_page, … }.

Quick try (curl)

curl https://api-dev.dokicasa.it/api/users/me/wallet \
  -H "Authorization: Bearer HfBfYShns3E02no3kkwCRWQugkVNcJCtrRN2BPoI5NxhqsiXaxxnSPpIHY2O"
# → { "wallet": 120.00, "real_wallet": 89.50 }

TIP

You can try them right away with the test token on the sandbox: they are read-only, free calls.