Account
Get Account Usage
Returns a full snapshot of your account status:
- Credits - total, used, and remaining for the current billing cycle
- Rate limits - current usage and reset times for daily, hourly, and per-minute windows
- Plan - your current plan category and renewal dates
- Pricing - credit cost per action type across all public API endpoints
Rate limit: This endpoint is limited to 5 requests per minute.
GET
/
v3
/
account
/
usage
Get Account Usage
curl --request GET \
--url https://api.lusha.com/v3/account/usage \
--header 'api_key: <api-key>'import requests
url = "https://api.lusha.com/v3/account/usage"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://api.lusha.com/v3/account/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.lusha.com/v3/account/usage")
.header("api_key", "<api-key>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/account/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"credits": {
"total": 10000,
"used": 1500,
"remaining": 8500
},
"rateLimits": {
"daily": {
"limit": 5000,
"used": 120,
"remaining": 4880,
"resetsAt": "2026-03-31T00:00:00.000Z"
}
},
"plan": {
"category": "professional",
"renewalType": "annual",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2027-01-01T00:00:00.000Z"
},
"pricing": {
"revealEmail": {
"credits": 1,
"perQuantity": 1
},
"revealPhone": {
"credits": 5,
"perQuantity": 1
}
}
}Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Was this page helpful?
⌘I
Get Account Usage
curl --request GET \
--url https://api.lusha.com/v3/account/usage \
--header 'api_key: <api-key>'import requests
url = "https://api.lusha.com/v3/account/usage"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://api.lusha.com/v3/account/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.lusha.com/v3/account/usage")
.header("api_key", "<api-key>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/account/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"credits": {
"total": 10000,
"used": 1500,
"remaining": 8500
},
"rateLimits": {
"daily": {
"limit": 5000,
"used": 120,
"remaining": 4880,
"resetsAt": "2026-03-31T00:00:00.000Z"
}
},
"plan": {
"category": "professional",
"renewalType": "annual",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2027-01-01T00:00:00.000Z"
},
"pricing": {
"revealEmail": {
"credits": 1,
"perQuantity": 1
},
"revealPhone": {
"credits": 5,
"perQuantity": 1
}
}
}