Skip to main content

A guide to Lusha's API environment on Postman

How to set up and use Lusha's Postman collection to test the Person, Company, and Prospecting APIs.

Written by Hila
Updated this week

Lusha's API gives you programmatic access to contact and company data. To help you test requests quickly, Lusha provides a ready-to-use Postman collection with pre-configured endpoints and example requests.

πŸ’‘ Note: API access is available on Premium and Scale plans only.

Setting up the Postman environment

  1. Click the Run in Postman button in the Lusha API documentation to import the collection, or find it directly in Postman.

  2. In Postman, go to Environments and create a new environment.

  3. Add a variable named API_KEY and set its value to your Lusha API key.

  4. Make sure this environment is selected before running any requests.

Collection structure

Once imported, the collection is organised into the following folders:

  • Contact Enrichment β€” GET Person V2 (single) and POST Person V2 Bulk

  • Company Enrichment β€” GET Company (single) and POST Company Bulk

  • Filters for Prospecting β€” company and contact filter primitives (industries, sizes, departments, seniority, locations, etc.)

  • Prospecting β€” Contact and Company Prospecting Search & Enrich (POST)

  • Credit Usage β€” GET Credit Usage to check your account's credit consumption

Accessing saved examples

Each endpoint includes pre-saved examples showing the request structure, parameters, and expected responses.

  1. Select any request in the collection.

  2. Click the folder dropdown next to the request name.

  1. Choose an example to view the saved request and response format.

Modify the parameters as needed and run the request to see live data.

Best practices

  • Store your API key using Postman's environment variables β€” never hard-code it.

  • Use the Save Responses feature to track changes in API output over time.

  • Check the Body tab for response data. API responses are in JSON format with fields such as emails, phones, and company_info.

  • Use Pretty view for easier readability.

For full API reference, see Lusha's API documentation. For questions, contact Support via the chat icon in your dashboard or email [email protected].

Did this answer your question?