v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Decision Makers

Get Decision Makers

Resolve each supplied company to a Lusha company ID, rank the most relevant decision makers per company using the buying-committee-ranker model, and return them grouped per company.

Results are free previews — name, title, company, location, LinkedIn, seniority, and department — with has and canReveal fields. Reveal emails and phones separately via Enrich Contacts.

Accepted company identifiers (exactly one required per entry):

  • domain — resolved to a Lusha company ID server-side
  • id — encrypted Lusha company ID (vN.…); legacy numeric IDs accepted during transition
post/v3/contacts/decision-makers

Request body

Example request

{
  "companies": [
    {
      "domain": "google.com",
      "id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
      "clientReferenceId": "ref-1"
    }
  ],
  "pagination": {
    "size": 10
  }
}

Response

Successful response

requestIdstring uuid

Example response

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "results": [
    {
      "clientReferenceId": "ref-1",
      "companyId": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
      "domain": "unknown-co.com",
      "decisionMakers": [
        {
          "clientReferenceId": "my-ref-1",
          "id": "4389064704",
          "firstName": "Orit",
          "lastName": "Shilvock",
          "jobTitle": {
            "title": "Vice President of Partnerships",
            "departments": [
              "Business Development"
            ],
            "seniority": "Vice President"
          },
          "company": {
            "id": "16303253",
            "name": "Lusha",
            "domain": "www.lusha.com"
          },
          "location": {
            "country": "Israel",
            "state": "Tel Aviv District",
            "city": "Tel Aviv"
          },
          "socialLinks": {
            "linkedin": "https://www.linkedin.com/in/orit-shilvock-6243bb5"
          },
          "has": [
            "firstName",
            "lastName",
            "jobTitle",
            "location",
            "socialLinks",
            "emails"
          ],
          "canReveal": [
            {
              "field": "emails",
              "credits": 1
            }
          ],
          "signalTypes": [
            "promotion",
            "companyChange"
          ],
          "error": {
            "code": "NOT_FOUND",
            "message": "Contact not found"
          }
        }
      ],
      "error": {
        "code": "NOT_FOUND",
        "message": "Contact not found"
      }
    }
  ],
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}