1. Payment & Wallet
  • Litemail
    • Litemail Docs
    • Users
      • Retrieve User Details
    • Workspaces
      • Retrieve All Workspaces
      • Create New Workspace
      • Update Workspace
    • Billings
      • Add Billing Details
    • Mailboxes
      • Retrieve Mailboxes
      • Assign New Mailbox to Domain
      • Get Mailbox Details
      • Update Mailbox
      • Remove Mailbox (Next Renewal)
    • Payment & Wallet
      • Get Wallet Balance
        GET
      • Add Balance to Wallet
        POST
      • Enable Auto Recharge
        POST
    • Exports
      • Export Mailboxes
      • Add Third Party Account Details
      • Update Third Party Account Details
    • Subscriptions
      • Get All Subscriptions
      • Cancel Subscription
      • Upgrade Subscription
    • Domains
      • Retrieve Domains
      • List Assignable Domains
      • Add DMARC Records
      • Add Domain Forwarding
      • Remove Domain Forwarding
      • Get Name Servers
      • Verify Name Server Propagation
      • Connect Domains with LiteMail AI
      • Enable Email Forwarding
      • Remove Email Forwarding
      • Enable Catch-All Emails
      • Remove Catch-All Emails
      • Check DNS Records
      • Remove Unused Domain
      • Get Available Domains for Registration
      • Get Domain Purchase Payment Link
    • DNS
      • Get DNS Records
      • Add DNS Record
      • Update DNS Record
      • Delete DNS Record
    • apikeys testing
      • generate key by login first
    • Connect Inbox
      • connect-inboxes
  • LiteMail API v3
    • Users
      • Retrieve User Details
    • Domains
      • Retrieve Domains
      • Purchase/Register a New Domain
      • List Assignable Domains
      • Add DMARC Records
      • Add Domain Forwarding
      • Remove Domain Forwarding
      • Get Name Servers
      • Verify Name Server Propagation
      • Connect Domains with LiteMail
      • Enable Email Forwarding
      • Remove Email Forwarding
      • Enable Catch-All Emails
      • Remove Catch-All Emails
      • Check DNS Records
      • Get Domain Details
      • Remove Unused Domain
      • Get Available Domains for Registration
      • Get Domain Purchase Payment Link
    • Mailboxes
      • Retrieve Mailboxes
      • Assign New Mailbox to Domain
      • Get Mailbox Details
      • Update Mailbox
      • Remove Mailbox (Next Renewal)
      • Get Warmup Analytics for Mailboxes
    • Workspaces
      • Retrieve All Workspaces
      • Create New Workspace
      • Update Workspace
    • Billings
      • Add Billing Details
    • Payment & Wallet
      • Get Wallet Balance
      • Add Balance to Wallet
      • Enable Auto Recharge
    • Wallet
      • Add Credit to Wallet
      • List Billing Invoices
    • Exports
      • Export Mailboxes
      • Add Third Party Account Details
      • Update Third Party Account Details
      • Connect Inboxes (Export to Platform)
    • Subscriptions
      • Get All Subscriptions
      • Cancel Subscription
      • Upgrade Subscription
    • DNS
      • Get DNS Records
      • Create DNS Record
      • Update DNS Record
      • Delete DNS Record
    • Tags
      • List Tags
      • Create Tag
      • Update Tag
      • Delete Tag
    • MailBoxes
      • Assign Mailboxes to Domain
    • Placement
      • List Placement Tests
      • Create Placement Test
    • Dashboard
      • Get Dashboard Overview
      • Get Mailbox Status Counts
    • Export History
      • List Export History
      • Create Export History Record
    • Cloudflare
      • Get Cloudflare Credentials & Zones
      • Save Credentials or Connect Domain
    • Webhooks
      • List Registered Webhooks
      • Register a New Webhook Endpoint
      • Delete a Webhook
  1. Payment & Wallet

Get Wallet Balance

GET
/v1/wallet
Retrieve the current wallet balance for the authenticated user.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw.
Example:
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw ********************
or

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.litemail.ai/v1/wallet' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw <token>'

Responses

🟢200OK
application/json
Wallet balance retrieved successfully
Bodyapplication/json

Example
{
    "status": 200,
    "message": "Wallet balance retrieved successfully",
    "data": {
        "userId": "cmg9jatbj0000jv04cejuz12b",
        "balance": 250.75,
        "currency": "USD",
        "lastUpdated": "2025-10-04T12:30:00Z"
    }
}
🟠401Unauthorized
Previous
Remove Mailbox (Next Renewal)
Next
Add Balance to Wallet
Built with