Account Usage

GET

account

usage

Get Account Usage

curl --request GET \
  --url https://api.lusha.com/v3/account/usage \
  --header 'api_key: <api-key>'

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));

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
    }
  }
}

Returns a full snapshot of your account status: credits (total, used, and remaining), rate limits (daily, hourly, and minute usage and reset times), your plan’s category and renewal dates, and per-action credit pricing.

This endpoint has its own rate limit - 5 requests per minute - lower than most other V3 endpoints. Poll it on a schedule (for example, once at the start of a batch job) rather than before every API call.

Endpoint

GET https://api.lusha.com/v3/account/usage

Authentication

string

required

Your Lusha API key.

This endpoint takes no query parameters or request body.

Response

object

Your account’s credit balance for the current period.

Show properties

number

Total credits included in your plan. Example: 10000

number

Credits consumed so far. Example: 1500

number

Credits still available. Example: 8500

object

Your current usage against each rate-limit window. Any of daily, hourly, or minute can be null if that window doesn’t apply to your plan.

Show properties

object | null

Show properties

number

Total requests allowed in this window. Example: 5000

number

Requests made so far in this window. Example: 120

number

Requests remaining in this window. Example: 4880

string

ISO 8601 timestamp when this window resets. Example: 2026-03-31T00:00:00.000Z

object | null

Same shape as daily, scoped to the current hourly window.

object | null

Same shape as daily, scoped to the current minute window.

object

Your account’s plan details.

Show properties

string

Plan category. Example: "professional"

string

Billing cycle. Example: "annual"

string

ISO 8601 plan start date. Example: "2026-01-01T00:00:00.000Z"

string

ISO 8601 plan renewal/end date. Example: "2027-01-01T00:00:00.000Z"

object

A map of billing action names to their credit cost. Keys correspond to the actions referenced throughout the V3 API - for example api_search (prospecting and search), reveal_company (company enrich), lookalikeContact / lookalikeCompany (lookalikes), and showSignalsContact / showSignalsCompany (signals) - plus per-data-point keys used for contact enrichment.

Show each entry

number

Credits charged per perQuantity units. Example: 1

number

The unit size the credits charge applies to. Example: 25

The exact set of keys and their values depend on your plan - call this endpoint to see the current catalog for your account rather than hardcoding action names.

Error codes

Status	Meaning
`401`	Unauthorized - invalid or missing API key
`403`	Forbidden - account inactive or V3 access not enabled
`429`	Too many requests - rate limit exceeded (max 5 req/min)
`500`	Internal server error - retry with exponential backoff

Example

curl --request GET \
  --url https://api.lusha.com/v3/account/usage \
  --header 'api_key: YOUR_API_KEY'

Example response

{
  "credits": {
    "total": 10000,
    "used": 1500,
    "remaining": 8500
  },
  "rateLimits": {
    "daily": {
      "limit": 5000,
      "used": 120,
      "remaining": 4880,
      "resetsAt": "2026-03-31T00:00:00.000Z"
    },
    "hourly": {
      "limit": 500,
      "used": 20,
      "remaining": 480,
      "resetsAt": "2026-03-30T15:00:00.000Z"
    },
    "minute": {
      "limit": 25,
      "used": 1,
      "remaining": 24,
      "resetsAt": "2026-03-30T14:31:00.000Z"
    }
  },
  "plan": {
    "category": "professional",
    "renewalType": "annual",
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2027-01-01T00:00:00.000Z"
  },
  "pricing": {
    "api_search": { "credits": 1, "perQuantity": 1 },
    "reveal_company": { "credits": 1, "perQuantity": 1 },
    "email": { "credits": 1, "perQuantity": 25 },
    "phone": { "credits": 5, "perQuantity": 1 }
  }
}

Poll this endpoint on a schedule rather than before every request, and set a low-credit alert on credits.remaining so batch jobs pause before they run out mid-run.

Authorizations

api_key

string

header

required

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.

Response

Successfully retrieved account usage

credits

object

Show child attributes

rateLimits

object

Show child attributes

plan

object

Show child attributes

pricing

object

Show child attributes

⌘I

Get Account Usage

curl --request GET \
  --url https://api.lusha.com/v3/account/usage \
  --header 'api_key: <api-key>'

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));

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
    }
  }
}

Overview

Resources

Endpoints

Endpoint

Authentication

Response

Error codes

Example

Authorizations

Response

​Endpoint

​Authentication

​Response

​Error codes

​Example

Authorizations

Response

Endpoint

Authentication

Response

Error codes

Example