Lusha Enrichment API

openapi: 3.2.0
info:
  title: Lusha API Documentation Enrichment API
  version: ''
  x-logo:
    url: https://www.lusha.com/logo.png
  license:
    name: Proprietary
    url: https://lusha.com/legal/terms
  description: "<blockquote class=\"callout-warning\">\n\n⚠️ **This version is soon to be deprecated.** Please [migrate to V3](/apis/openapi).\n\n</blockquote>\n\n---\n\nLusha provides a RESTful API that allows you to query a comprehensive\ndataset of business profiles and company information.\n\nIt is designed for teams building prospecting, enrichment, automation, and analytics workflows that require accurate, continuously updated business data. The API supports both real-time and bulk use cases and is suitable for production environments.\n\nUse the Lusha API to search for new prospects, enrich existing records, react to real-world changes, and expand coverage using lookalike recommendations.\n\n*All API requests should be made over HTTPS (SSL), and the response bodies are delivered in JSON format.*\n\n---\n    <style>\n    body {\n        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;\n        margin: 0;\n        padding: 0;\n        background: #ffffff;\n    }\n\n    .endpoint-link {\n        color: #0969da;\n        text-decoration: none;\n        transition: all 0.2s ease;\n    }\n\n    .endpoint-link:hover {\n        color: #0550ae;\n        text-decoration: underline;\n    }\n\n    .endpoint-url {\n        font-family: 'SF Mono', Monaco, 'Cascadia Code', monospace;\n        font-size: 9px;\n        color: #6b7280;\n        background: #f3f4f6;\n        padding: 3px 6px;\n        border-radius: 4px;\n        margin-top: 8px;\n        margin-bottom: 10px;\n        display: inline-block;\n    }\n\n    details summary:hover {\n        color: #4b5563;\n    }\n</style>\n\n<div style=\"max-width: 900px; margin: 0 auto; padding: 15px;\">\n    <div style=\"display: grid; grid-template-columns: repeat(2, 1fr); gap: 12px;\">\n\n        <!-- Person Card -->\n        <div style=\"background: #fafbfc; border: 1px solid #d1d5db; border-radius: 6px; padding: 14px; min-height: 160px;\">\n            <h3 style=\"margin: 0 0 8px 0; color: #1f2937; font-size: 14px; font-weight: 600; padding-bottom: 6px; border-bottom: 1px solid #e5e7eb;\">\n                Person\n            </h3>\n            <ul style=\"font-size: 12px; line-height: 1.4; margin: 0; padding-left: 0; list-style: none;\">\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/searchSingleContact\" class=\"endpoint-link\">Person Enrichment</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/searchProspectingContacts\" class=\"endpoint-link\">Contact Search &amp; Enrich</a></li>\n            </ul>\n\n            <div class=\"endpoint-url\">https://api.lusha.com/v2/person</div>\n\n            <details style=\"margin-top: 10px; padding-top: 8px; border-top: 1px solid #e5e7eb;\">\n                <summary style=\"cursor: pointer; font-size: 10px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; margin: 0 0 6px 0; list-style: none;\">\n                    ▶ Common Use Cases\n                </summary>\n                <ul style=\"font-size: 11px; line-height: 1.4; margin: 0; padding-left: 14px; list-style: none; color: #4b5563;\">\n                    <li style=\"padding: 1px 0;\">• Form enrichment</li>\n                    <li style=\"padding: 1px 0;\">• CRM completion</li>\n                    <li style=\"padding: 1px 0;\">• Outbound personalization</li>\n                </ul>\n            </details>\n        </div>\n\n        <!-- Company Card -->\n        <div style=\"background: #fafbfc; border: 1px solid #d1d5db; border-radius: 6px; padding: 14px; min-height: 160px;\">\n            <h3 style=\"margin: 0 0 8px 0; color: #1f2937; font-size: 14px; font-weight: 600; padding-bottom: 6px; border-bottom: 1px solid #e5e7eb;\">\n                Company\n            </h3>\n            <ul style=\"font-size: 12px; line-height: 1.4; margin: 0; padding-left: 0; list-style: none;\">\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/searchSingleCompanyV2\" class=\"endpoint-link\">Company Enrichment</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/searchProspectingCompanies\" class=\"endpoint-link\">Company Search &amp; Enrich</a></li>\n            </ul>\n\n            <div class=\"endpoint-url\">https://api.lusha.com/v2/company</div>\n\n            <details style=\"margin-top: 10px; padding-top: 8px; border-top: 1px solid #e5e7eb;\">\n                <summary style=\"cursor: pointer; font-size: 10px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; margin: 0 0 6px 0; list-style: none;\">\n                    ▶ Common Use Cases\n                </summary>\n                <ul style=\"font-size: 11px; line-height: 1.4; margin: 0; padding-left: 14px; list-style: none; color: #4b5563;\">\n                    <li style=\"padding: 1px 0;\">• Account enrichment</li>\n                    <li style=\"padding: 1px 0;\">• Routing, scoring, territory logic</li>\n                    <li style=\"padding: 1px 0;\">• Market analysis &amp; segmentation</li>\n                </ul>\n            </details>\n        </div>\n\n        <!-- Signals Card -->\n        <div style=\"background: #fafbfc; border: 1px solid #d1d5db; border-radius: 6px; padding: 14px; min-height: 160px;\">\n            <h3 style=\"margin: 0 0 8px 0; color: #1f2937; font-size: 14px; font-weight: 600; padding-bottom: 6px; border-bottom: 1px solid #e5e7eb;\">\n                Signals\n            </h3>\n            <ul style=\"font-size: 12px; line-height: 1.4; margin: 0; padding-left: 0; list-style: none;\">\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/getContactSignalsById\" class=\"endpoint-link\">Contact Signals</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/getCompanySignalsById\" class=\"endpoint-link\">Company Signals</a></li>\n            </ul>\n\n            <div class=\"endpoint-url\">https://api.lusha.com/v2/signals</div>\n\n            <details style=\"margin-top: 10px; padding-top: 8px; border-top: 1px solid #e5e7eb;\">\n                <summary style=\"cursor: pointer; font-size: 10px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; margin: 0 0 6px 0; list-style: none;\">\n                    ▶ Common Use Cases\n                </summary>\n                <ul style=\"font-size: 11px; line-height: 1.4; margin: 0; padding-left: 14px; list-style: none; color: #4b5563;\">\n                    <li style=\"padding: 1px 0;\">• Job change tracking</li>\n                    <li style=\"padding: 1px 0;\">• Company updates signals</li>\n                    <li style=\"padding: 1px 0;\">• News event alerts</li>\n                </ul>\n            </details>\n        </div>\n\n        <!-- Lookalikes Card -->\n        <div style=\"background: #fafbfc; border: 1px solid #d1d5db; border-radius: 6px; padding: 14px; min-height: 160px;\">\n            <h3 style=\"margin: 0 0 8px 0; color: #1f2937; font-size: 14px; font-weight: 600; padding-bottom: 6px; border-bottom: 1px solid #e5e7eb;\">\n                Lookalikes\n            </h3>\n            <ul style=\"font-size: 12px; line-height: 1.4; margin: 0; padding-left: 0; list-style: none;\">\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/getContactLookalikes\" class=\"endpoint-link\">Similar Contacts</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/getCompanyLookalikes\" class=\"endpoint-link\">Similar Companies</a></li>\n            </ul>\n\n            <div class=\"endpoint-url\">https://api.lusha.com/v3/lookalike</div>\n\n            <details style=\"margin-top: 10px; padding-top: 8px; border-top: 1px solid #e5e7eb;\">\n                <summary style=\"cursor: pointer; font-size: 10px; font-weight: 600; color: #6b7280; text-spacing: 0.5px; margin: 0 0 6px 0; list-style: none;\">\n                    ▶ Common Use Cases\n                </summary>\n                <ul style=\"font-size: 11px; line-height: 1.4; margin: 0; padding-left: 14px; list-style: none; color: #4b5563;\">\n                    <li style=\"padding: 1px 0;\">• Market expansion</li>\n                    <li style=\"padding: 1px 0;\">• Similar account discovery</li>\n                    <li style=\"padding: 1px 0;\">• Prospect recommendations</li>\n                </ul>\n            </details>\n        </div>\n\n        <!-- Filters Card -->\n        <div style=\"background: #fafbfc; border: 1px solid #d1d5db; border-radius: 6px; padding: 14px; min-height: 160px;\">\n            <h3 style=\"margin: 0 0 8px 0; color: #1f2937; font-size: 14px; font-weight: 600; padding-bottom: 6px; border-bottom: 1px solid #e5e7eb;\">\n                Filters\n            </h3>\n            <ul style=\"font-size: 12px; line-height: 1.4; margin: 0; padding-left: 0; list-style: none;\">\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/getSignalOptions\" class=\"endpoint-link\">Signal Options</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#tag/Contact-Filters\" class=\"endpoint-link\">Contact Filters</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#tag/Company-Filters\" class=\"endpoint-link\">Company Filters</a></li>\n            </ul>\n        </div>\n\n        <!-- Account Card -->\n        <div style=\"background: #fafbfc; border: 1px solid #d1d5db; border-radius: 6px; padding: 14px; min-height: 160px;\">\n            <h3 style=\"margin: 0 0 8px 0; color: #1f2937; font-size: 14px; font-weight: 600; padding-bottom: 6px; border-bottom: 1px solid #e5e7eb;\">\n                Account\n            </h3>\n            <ul style=\"font-size: 12px; line-height: 1.4; margin: 0; padding-left: 0; list-style: none;\">\n                <li style=\"padding: 2px 0;\">• <a href=\"/guides\" class=\"endpoint-link\">Getting started</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#operation/getAccountUsageStats\" class=\"endpoint-link\">Credit Usage</a></li>\n                <li style=\"padding: 2px 0;\">• <a href=\"#tag/Account-Management\" class=\"endpoint-link\">Rate Limits</a></li>\n            </ul>\n        </div>\n\n    </div>\n</div>\n\n  <!-- WEBHOOKS FEATURED BANNER -->\n  <div style=\"background: #f8f9fa; border: 1px solid #e5e7eb; padding: 18px 20px; border-radius: 8px; margin-top: 20px; box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);\">\n      <div style=\"display: flex; align-items: center; gap: 14px;\">\n          <div style=\"flex: 1;\">\n              <div style=\"display: flex; align-items: center; gap: 8px; margin-bottom: 6px;\">\n                  <strong style=\"font-size: 16px; color: #1f2937;\">Webhooks API</strong>\n                  <span style=\"background-color: #dbeafe; color: #1e40af; padding: 2px 8px; border-radius: 4px; font-size: 10px; font-weight: 600;\">NEW</span>\n              </div>\n              <p style=\"font-size: 13px; margin: 0 0 12px 0; color: #6b7280; line-height: 1.5;\">\n                  Subscribe to real-time notifications when contacts change jobs or companies experience key business events.\n              </p>\n              <a href=\"#tag/Webhooks\" style=\"background: #2563eb; color: white; padding: 8px 16px; border-radius: 6px; text-decoration: none; font-size: 12px; font-weight: 600; display: inline-block; transition: all 0.2s;\">\n                  View Documentation →\n              </a>\n          </div>\n      </div>\n  </div>\n\n<script>\n    document.addEventListener('DOMContentLoaded', function() {\n        const details = document.querySelectorAll('details');\n        details.forEach(detail => {\n            detail.addEventListener('toggle', function() {\n                const summary = this.querySelector('summary');\n                if (summary) {\n                    if (this.open) {\n                        summary.innerHTML = '▼ Common Use Cases';\n                    } else {\n                        summary.innerHTML = '▶ Common Use Cases';\n                    }\n                }\n            });\n        });\n    });\n</script>\n\n---\n\n**<strong style=\"font-size: 1.2em; display: block; margin: 20px 0 10px 0;\">Data Source and Privacy</strong>**\n\nPlease note that **Lusha is a search platform**, meaning the data provided\nis not created or directly managed by us. Instead, it is retrieved from\npublicly available sources and through contributions from trusted business\npartners.\n\nFor more information on how we collect, use, and handle business profiles,\nplease refer to our [Privacy Policy](https://lusha.com/legal/privacy-notice/).\n\n----\n\n## Authentication\n\nAPI keys are required for all API and MCP requests and are tied to your Lusha account and plan. To access the Lusha API, you must authenticate your requests using your API\nkey. This key is unique to your account and is used to identify your usage\nof the API.\n\n**How to Authenticate:**\n\nWhen making an API call, include your API key in the `api_key` header of the request.\n\n> You can generate and retrieve your API key [here](https://dashboard.lusha.com/enrich/api).\n\nAPI keys should be stored securely and used only in server-side environments.\n\n---\n\n## Rate Limiting\n\nLusha enforces rate limits on a per-plan basis to ensure fair usage and platform stability. Limits are applied across multiple time windows (per minute, per hour, and per day), and vary depending on your account plan.\n\nRate limits for the **Credit Usage API** differ from standard endpoint limits.\n\n> **Note:** To check your current plan's limits, visit the [Lusha Help Center](https://info.lusha.com/en/articles/163856-all-there-is-to-know-about-lusha-s-api) or contact your account manager.\n\n**Rate Limit Response Headers**\n\nTo monitor your current rate limit status, check the HTTP response headers\nin your API calls:\n\n| Header | Description |\n|--------|-------------|\n| `x-rate-limit-daily` | The total number of requests allowed per day under your current plan |\n| `x-daily-requests-left` | The number of requests remaining in your daily quota |\n| `x-daily-usage` | The number of requests you have made in the current daily period |\n| `x-rate-limit-hourly` | The total number of requests allowed per hour under your current plan |\n| `x-hourly-requests-left` | The number of requests remaining in your hourly quota |\n| `x-hourly-usage` | The number of requests you have made in the current hourly period |\n| `x-rate-limit-minute` | The total number of requests allowed per minute under your current plan |\n| `x-minute-requests-left` | The number of requests remaining in your current minute window |\n| `x-minute-usage` | The number of requests you have made in the current minute window |\n\n---\n\n## Error Codes\n\nLusha API uses standard HTTP response codes to indicate the status of your request.\n\n| Status Code | Name | Description |\n|-------------|------|-------------|\n| **200** | OK | Successful request |\n| **400** | Bad Request | Badly formatted request |\n| **401** | Unauthorized | The API key is invalid |\n| **402** | Payment Required | Your account requires payment |\n| **403** | Forbidden | Your account is not active. Please reach out to support at *support@lusha.com* for assistance |\n| **403** | Forbidden | Your pricing version does not support requesting individual datapoints [revealEmails, revealPhones] |\n| **404** | Not Found | The requested endpoint was not found |\n| **412** | Precondition Failed | The request failed due to invalid syntax that was provided. Please make sure to send a full name field that contains a valid first & last name |\n| **429** | Too Many Requests | You've reached your trial limit, please contact support for upgrade |\n| **429** | Too Many Requests | Daily API quota limit exceeded. Limit X calls per day |\n| **429** | Too Many Requests | Hourly API rate limit exceeded. Limit: X calls per hour. Reset in X seconds |\n| **451** | Unavailable For Legal Reasons | We are unable to process this contact request due to our GDPR regulations |\n| **499** | Client Closed Request | Request failed due to request timeout |\n| **5XX** | Server Error | There's a problem on Lusha's end |\n\n**Error Response Format**\n\nIn case of an error, the response body will contain details about the error:\n\n  ```json\n      {\n        \"error\": {\n          \"code\": 400,\n          \"message\": \"Invalid request parameters\"\n        }\n      }\n  ```\n\n**Handling errors**\n\n- Always ensure your API key is correct and valid\n- Pay attention to the specific error message and code to troubleshoot issues efficiently\n- Implement proper error handling and retry logic in your application\n- For 5XX errors, implement exponential backoff before retrying\n\n---\n"
  contact:
    name: Lusha Support
    url: https://api.lusha.com
    email: support@lusha.com
  termsOfService: https://lusha.com/legal/terms
  x-privacy-policy:
    name: Privacy Policy
    url: https://lusha.com/legal/privacy-notice/
servers:
- url: https://api.lusha.com
  description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Enrichment
  description: '**What is enrichment?**


    Enrichment is the process of adding missing or updated data to existing contact or company records.


    Use enrichment to:

    - Complete CRM records

    - Improve outbound accuracy and deliverability

    - Keep records current as people and companies change


    > Enrichment can be performed in real time or in bulk, depending on the endpoint and use case.


    **Available enrichment APIs**


    Person enrichment:

    - **Search single contact** — Enrich one contact at a time

    - **Search multiple contacts** — Bulk enrich contacts


    Company enrichment:

    - **Search a single company** — Enrich one company at a time

    - **Search multiple companies** — Bulk enrich companies'
paths:
  /v2/person:
    get:
      tags:
      - Enrichment
      summary: Search Single Contact
      description: "Find and enrich a single contact using various search criteria. You can search by name, email,\nLinkedIn URL, or Person Id.\n>##### Endpoint\n  ```\nGET https://api.lusha.com/v2/person\n  ```\n\n\n>##### Search Requirements\nYou must provide either:\n- `personId` OR\n- `email` OR\n- `linkedinUrl` OR\n- `firstName` AND `lastName` AND (`companyName` OR `companyDomain`)\n\n>##### Notes:\n- Provide as much information as possible for better results\n- Using `personId` provides the most direct way to retrieve contact information, as it uniquely identifies a contact in Lusha's database.\n- Use `refreshJobInfo=true` to get the latest employment data\n- Use `filterBy` parameter to specify what contact details you need\n- Include the `signals` parameter to retriever contact signals (If no signals data is found for the specified period, the `signals` object will be empty but still present in the response.)\n  - When requesting signals, you can optionally specify a start date using `signalsStartDate`.\n  - Signals data is optional. If you don't include the `signals` parameter, no signals data will be returned.\n\n\n\n---\n\n⚠️ **Important Notice - Unified Credits Plan Required**\n\n| Parameter | Requirement |\n|-----------|-------------|\n| `revealEmails` and `revealPhones` | Only available to customers on the **Unified Credits** pricing plan |\n| Plan Restriction | Attempting to use these parameters on other plans will result in a **403 Unauthorized** error |\n| Default Behavior | When neither parameter is used, the API returns **both email addresses and phone numbers**, if available |\n\n---\n"
      operationId: searchSingleContact
      parameters:
      - $ref: '#/components/parameters/firstName'
      - $ref: '#/components/parameters/lastName'
      - $ref: '#/components/parameters/personId'
      - $ref: '#/components/parameters/companyName'
      - $ref: '#/components/parameters/companyDomain'
      - $ref: '#/components/parameters/email'
      - $ref: '#/components/parameters/linkedinUrl'
      - $ref: '#/components/parameters/refreshJobInfo'
      - $ref: '#/components/parameters/filterBy'
      - $ref: '#/components/parameters/revealEmails'
      - $ref: '#/components/parameters/revealPhones'
      - $ref: '#/components/parameters/signals'
      - $ref: '#/components/parameters/signalsStartDate'
      - $ref: '#/components/parameters/partialProfile'
      responses:
        '200':
          description: Successfully found contact information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SingleContactResponse'
              examples:
                successful_response:
                  summary: Successful contact lookup
                  value:
                    contact:
                      error: null
                      isCreditCharged: false
                      data:
                        companyId: 33222678
                        firstName: Dustin
                        lastName: Moskovitz
                        fullName: Dustin Moskovitz
                        emailAddresses:
                        - address: dustin@lusha.com
                          type: work
                          emailConfidence: A+
                          updateDate: '2024-01-15'
                        phoneNumbers:
                        - number: +1-555-123-4567
                          phoneType: Mobile
                          doNotCall: false
                          updateDate: '2024-01-15'
                        location:
                          country: United States
                          countryIso2: US
                          continent: North America
                          rawLocation: Boston, MA, US
                          city: Boston
                          state: Massachusetts
                          stateCode: MA
                          isEuContact: false
                        jobTitle:
                          seniority: Executive
                          title: CEO
                          departments:
                          - Executive
                        socialLinks:
                          linkedin: https://www.linkedin.com/in/dustin/
                          xUrl: https://twitter.com/dustin
                        jobStartDate: '2020-01-01'
                        personId: 123456
                        updateDate: '2024-01-15'
                        linkedinFollowersCount: 12500
                        linkedinConnectionsCount: 500
                        linkedinCertifications:
                        - companyName: Microsoft
                          title: 'Microsoft Certified: Azure Fundamentals'
                          dateYear: 2020
                          dateMonth: 6
                          verifyUrl: https://www.youracclaim.com/badges/5ccf865c-dd6e-4dcc-9184-c8999d31f83d
                        linkedinCourses:
                        - title: Advanced Leadership Strategies
                          companyName: LinkedIn Learning
                        linkedinAwards:
                        - title: Tech Leader of the Year
                          companyName: Tech Awards Council
                          dateYear: 2023
                          summary: Recognition for outstanding leadership in technology innovation
                        linkedinSkills:
                        - Strategic Planning
                        - Team Leadership
                        - Product Development
                        company:
                          name: Lusha
                          description: Lusha is the sales intelligence platform designed to help businesses get their next customers.
                          domains:
                            homepage: https://www.lusha.com
                            email: lusha.com
                          fqdn: lusha.com
                          location:
                            country: United States
                            countryIso2: US
                            continent: North America
                            rawLocation: Boston, MA, US
                            city: Boston
                            state: Massachusetts
                          companySize:
                          - 201
                          - 500
                          revenueRange:
                          - 10000000
                          - 50000000
                          logoUrl: https://logo.lusha.co/logo.jpg
                          social:
                            linkedin: https://linkedin.com/company/lusha
                            crunchbase: https://crunchbase.com/company/lusha
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '451':
          $ref: '#/components/responses/GDPRRestricted'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      tags:
      - Enrichment
      summary: Search Multiple Contacts
      description: "Enrich multiple contacts in a single request. This endpoint allows you to submit a list of contacts\nand receive enriched data for each one, including company information.\n\n>##### Endpoint:\n  ```\nPOST https://api.lusha.com/v2/person\n  ```\n\n\n>##### Notes\n  - You can process up to 100 contacts per request.\n  - Using `personId` provides the most direct way to retrieve contact information.\n  - At least one of `email`, `linkedinUrl`, or `company`/`domain` with `fullName` is required.\n\n\n---\n\n⚠️ **Important Notice - Unified Credits Plan Required**\n\n| Parameter | Requirement |\n|-----------|-------------|\n| `revealEmails` and `revealPhones` | Only available to customers on the **Unified Credits** pricing plan |\n| Plan Restriction | Attempting to use these parameters on other plans will result in a **403 Unauthorized** error |\n| Default Behavior | When neither parameter is used, the API returns **both email addresses and phone numbers**, if available |\n\n---\n"
      operationId: searchMultipleContacts
      requestBody:
        required: true
        description: The list of contacts to enrich
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchBulkContactsRequest'
            examples:
              successful_response:
                summary: Successful contact lookup
                value:
                  contacts:
                  - contactId: '1'
                    personId: '4183886134'
                    fullName: John Doe
                    email: john@example.com
                    companies:
                    - name: Example Corp
                      domain: example.com
                      isCurrent: true
                  - contactId: '2'
                    personId: '4183886135'
                    linkedinUrl: https://www.linkedin.com/in/carolinaportela/
                  metadata:
                    revealEmails: true
                    revealPhones: true
                    signals:
                    - promotion
                    - companyChange
                    signalsStartDate: '2025-03-01'
                    partialProfile: true
      responses:
        '200':
          description: The list of enriched contacts with their company details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkPersonResponse'
              example:
                contacts:
                  '1':
                    error: null
                    isCreditCharged: false
                    data:
                      firstName: John
                      lastName: Doe
                      fullName: John Doe
                      companyId: 1586
                      contactTags: []
                      emails:
                      - john.doe@amazon.com
                      - johndoe@gmail.com
                      emailAddresses:
                      - email: john.doe@amazon.com
                        emailType: work
                        updateDate: '2025-11-17'
                        emailConfidence: A+
                      - email: johndoe@gmail.com
                        emailType: private
                        updateDate: '2025-11-17'
                        emailConfidence: A+
                      phones:
                      - +1 555-123-4567
                      phoneNumbers:
                      - number: +1 555-123-4567
                        phoneType: direct
                        doNotCall: false
                        updateDate: '2025-11-17'
                      personId: 1312840528
                      location:
                        country: United States
                        country_iso2: US
                        continent: North America
                        is_eu_contact: false
                        state: Massachusetts
                        state_code: MA
                        city: Boston
                        city_id: 4930956
                        location_coordinates:
                        - -71.05976867675781
                        - 42.358428955078125
                      jobTitle:
                        title: Engineering Manager
                        departments:
                        - Engineering & Technical
                        seniority: Manager
                      socialLinks:
                        linkedin: https://www.linkedin.com/in/johndoe
                        xUrl: https://twitter.com/johndoe
                      jobStartDate: '2022-03-01'
                      previousJob:
                        company:
                          name: TechCorp
                          domain: techcorp.com
                        jobTitle:
                          title: Senior Software Engineer
                          departments:
                          - Engineering & Technical
                      updateDate: '2025-11-17'
                      linkedinFollowersCount: 2800
                      linkedinConnectionsCount: 450
                      linkedinCertifications:
                      - companyName: AWS
                        title: AWS Certified Solutions Architect
                        dateYear: 2023
                        dateMonth: 8
                      linkedinCourses:
                      - school:
                          name: MIT
                        degree: Master of Engineering
                        startDateYear: 2018
                        endDateYear: 2020
                      linkedinAwards:
                      - title: Engineering Excellence Award
                        companyName: TechCorp
                        dateYear: 2021
                        dateMonth: 12
                      linkedinSkills:
                      - Cloud Architecture
                      - Team Leadership
                      - System Design
                  '2':
                    error: null
                    isCreditCharged: false
                    data:
                      firstName: Jane
                      lastName: Smith
                      fullName: Jane Smith
                      companyId: 33222678
                      contactTags: []
                      emails:
                      - jane.smith@lusha.com
                      emailAddresses:
                      - email: jane.smith@lusha.com
                        emailType: work
                        updateDate: '2025-11-18'
                        emailConfidence: A+
                      phones: []
                      phoneNumbers: []
                      personId: 3965070011
                      location:
                        country: United States
                        country_iso2: US
                        continent: North America
                        is_eu_contact: false
                      jobTitle:
                        title: Solutions Engineer
                        departments:
                        - Engineering & Technical
                        seniority: Non-Manager
                      socialLinks:
            

# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/openapi/lusha-enrichment-api-openapi.yml