Skip to main content

​
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 filtering.

​
Endpoint

GET /external/contacts/search

​
Authentication

See Authentication

​
Success status code

200 OK

​
Query parameters

NameRequiredTypeNotes
company_nameYesstringCompany name query, length 1 to 200.
roleNostringOptional role filter. Blank values are normalized away.
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20; maximum 100.

​
Response example

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

​
Error responses

  • 400 Bad Request
  • 401 Unauthorized

​
Notes

  • Email is intentionally not returned by this endpoint.
  • Short company queries use a direct contains-style fallback; longer company queries use scored matching.
  • Results are scoped to the authenticated user because the service computes user-specific reveal and task state before mapping the response.
  • Contact-style list responses follow the shared Pagination conventions.