{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"How Credits Work in Lusha","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"how-credits-work-in-lusha","__idx":0},"children":["How Credits Work in Lusha"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["What Lusha credits are, how they're consumed, and how to track usage."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits are Lusha's currency for unlocking contact data. Every time you reveal a contact's phone number or email address, Lusha deducts credits from your account's balance. Understanding how credits work helps you use them efficiently and avoid unexpected shortfalls."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-concepts","__idx":1},"children":["Key concepts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credits"]}," — consumed each time you reveal contact data (phone number or email)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Monthly credits"]}," — refreshed on your billing anniversary date each month on monthly plans"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Annual credits"]}," — allocated at the start of your annual contract"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared credits"]}," — on team plans, credits can be shared across the whole team or allocated per user (Admin-controlled in supported plans)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remaining credits"]}," — visible at any time in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usage Analytics (Press your name → Analytics)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-uses-a-credit","__idx":2},"children":["What uses a credit?"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Feature"},"children":["Feature"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Credits deducted"},"children":["Credits deducted"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform & Extension"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal email address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform & Extension"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal phone number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform & Extension"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal email + phone together"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Up to 6 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform & Extension"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Re-view an already-revealed contact"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform & Extension"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search, filter, or view company info"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal email (per contact)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal phone number (per contact)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal company info (full profile)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Single API request (per result returned)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per result"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bulk API request (up to 100 contacts/companies)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per 1–25 results"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API request with no results returned"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit (minimum)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API — Signals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Signals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per company"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API — Signals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contacts Signals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per contact"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact or company reveal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Same as Platform rate"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI chat prompts"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per 5 prompts"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI Data enrichment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per cell enriched"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signals enrichment (signal found)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per signal detected"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signals enrichment (no signal found)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CSV export"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per 25 rows"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CRM export (push to Salesforce / HubSpot)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per export"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lusha Data columns"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CRM columns (live Salesforce field values)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CSV Enrichment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Successfully enriched contact (matched)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Same as Platform rate"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CSV Enrichment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unmatched row (no data found)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommendations table"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal a blurred row (post-beta)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per row"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommendations table"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show contact email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommendations table"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show contact phone number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommendations table"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browsing / filtering / viewing the table"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 credits"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":["\n💡 *Note:* If you've already revealed a contact, viewing their details again does not use additional credits — even across sessions.\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"do-unused-credits-roll-over","__idx":3},"children":["Do unused credits roll over?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It depends on your plan type."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Monthly plans (Pro, Premium, Scale): Unused credits roll over to the next month, up to a maximum of 2× your monthly credit allowance. Once you reach that cap, no additional credits accumulate until you use some."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example: if your plan includes 100 credits per month and you use 40, you carry 60 forward — giving you 160 credits at the start of next month. If you use none at all, you still cap at 200."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Annual plans: Credits are allocated as a full-year pool at the start of your contract and don't reset monthly. Unused credits at the end of a contract term do not carry forward to renewal."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Free plan: Credits reset to your monthly allowance each billing cycle. Unused credits do not carry over."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"which-plan-do-i-have","__idx":4},"children":["Which plan do I have?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha offers five plans: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Free"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Starter"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pro"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Premium"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scale"]},". Each plan includes a set number of credits per month. Scale plan customers can also negotiate custom credit volumes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To see your current plan and credit balance: go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Payments & Subscription"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-team-credit-allocation-works","__idx":5},"children":["How team credit allocation works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Available for Admins and Managers on Pro, Premium, and Scale plans."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On our new Premium and Scale plans, Admins can choose between two credit modes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared pool"]}," — all team members draw from one combined credit balance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Per-user allocation"]}," — each user is assigned a fixed monthly credit limit"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure this: go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Team Management → Credit Allocation"]},". (Available for Admins only.)"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-warning"},"children":["\n⚠️ Important: Legacy Premium plans do not include the credit limit feature. To use this feature, please upgrade to one of our new pricing plans.\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-check-your-credit-usage","__idx":6},"children":["How to check your credit usage"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usage Analytics (Press your name → Analytics)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You'll see your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["total credits"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["credits used"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["credits remaining"]}," for the current cycle."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Managers and Admins can also view usage broken down by team member."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Credits reset at the start of each billing cycle. On ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["monthly"]}," plans, unused credits roll over up to 2× your monthly limit. For example, on a 100-credit plan, you can hold a maximum of 200 credits at any time."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-do-my-credits-reset","__idx":7},"children":["When do my credits reset?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your credits reset on your billing anniversary date — the same day of the month you first subscribed. Credits do not reset on the 1st of every month. For example, if your subscription started on the 15th, your credits reset on the 15th of each month."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To find your exact next reset date:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Payments & Subscription"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your next billing date is shown under your plan details — your credits reset on this same date."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," On annual plans, credits are allocated once at the start of your contract term and do not reset monthly. Contact your account manager if you need to adjust your annual credit allocation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You're all set — now you know exactly when to expect your credits to refresh. If you need more credits before your reset date, contact Lusha Support via the chat icon in your dashboard."]}]},"headings":[{"value":"How Credits Work in Lusha","id":"how-credits-work-in-lusha","depth":1},{"value":"Key concepts","id":"key-concepts","depth":2},{"value":"What uses a credit?","id":"what-uses-a-credit","depth":2},{"value":"Do unused credits roll over?","id":"do-unused-credits-roll-over","depth":2},{"value":"Which plan do I have?","id":"which-plan-do-i-have","depth":2},{"value":"How team credit allocation works","id":"how-team-credit-allocation-works","depth":2},{"value":"How to check your credit usage","id":"how-to-check-your-credit-usage","depth":2},{"value":"When do my credits reset?","id":"when-do-my-credits-reset","depth":2}],"frontmatter":{"title":"How Credits Work in Lusha","description":"What Lusha credits are, how they're consumed, and how to track usage.","seo":{"title":"How Credits Work in Lusha"}},"lastModified":"2026-06-24T07:07:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/getting-started/how-credits-work-in-lusha","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}