Skip to main content

Personnel list

List personnel records for a specific event. Use this endpoint when you want a paginated people directory for one event, with optional exhibitor, department, level, and search filters.

Endpoint

GET /external/personnel/list

Authentication

See Authentication

Success status code

200 OK

Query parameters

NameRequiredTypeNotes
event_idYesstringSupports either Event.eventId or internal Event.id.
exhibitor_idNostringFilter by a specific exhibitor.
departmentNostringDepartment filter.
levelNostringSeniority-level filter.
search_queryNostringName or job-title search.
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20; maximum 100.

Response example

{
  "items": [
    {
      "id": "789",
      "fullName": "Jane Smith",
      "title": "VP of Retail Technology",
      "department": "Technology",
      "seniorityLevel": "vp",
      "linkedinUrl": "https://linkedin.com/in/jane-smith",
      "companyName": "Acme Retail Systems",
      "sourceType": "exhibitor"
    }
  ],
  "total": 3,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "hasMore": false
}

Error responses

  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found

Notes

  • Personnel list responses intentionally use the lightweight contact-style public shape.
  • Pagination behavior follows the shared Pagination conventions.
  • Request-side identifiers use event_id and optional exhibitor_id, while response-side identifiers use only id.
  • search_query matches either relation position text or personnel fullName.