Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.lensmor.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Contacts search

Search contacts by company name. Use this endpoint when you want a lightweight contact result set keyed off a company query, with optional role and person-name filtering.

​
Endpoint

GET /external/contacts/search

​
Authentication

See Authentication

​
Success status code

200 OK

​
Query parameters

NameRequiredTypeNotes
company_nameYesstringCompany lookup term. Length 1 to 200.
roleNostringOptional position or role filter. Blank values are ignored.
person_nameNostringOptional person-name filter. Blank values are ignored.
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20, max 100.

​
Response body

​
Top-level fields

FieldTypeNotes
itemsobject[]Same contact summary shape as GET /external/personnel/list items[].
totalintegerTotal distinct personnel matches.
pageintegerCurrent page number.
pageSizeintegerPage size used for this response.
totalPagesinteger0 when total is 0.
hasMorebooleantrue when another page exists.

​
Response example

{
  "items": [
    {
      "id": "789",
      "fullName": "Jane Doe",
      "title": "VP Marketing",
      "department": "Marketing",
      "seniorityLevel": "vp",
      "linkedinUrl": "https://linkedin.com/in/jane-doe",
      "companyName": "Acme",
      "sourceType": "exhibitor",
      "email": null,
      "contactUnlockStatus": "locked"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "hasMore": false
}

​
Error responses

  • 400 Bad Request when company_name is empty or invalid.
  • 401 Unauthorized when the API key is missing, malformed, or invalid.

​
Notes

  • Request-side company_name is snake_case, while response-side fields are camelCase.
  • person_name can narrow the company-scoped result set by personnel name without requiring an event context.
  • email and contactUnlockStatus depend on the authenticated caller’s current access state.
  • Results reflect the authenticated caller’s current access state.