> ## 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. # Search personnel related events by name > Find paginated, deduplicated events for up to 50 personnel records with the exact full name. Matching ignores case and surrounding whitespace. Date filters use event start dates; `date_start_from` defaults to `2026-01-01`. A non-empty result consumes `50` credits; an empty result consumes `0`. Up to `10 requests` can run concurrently per user. `attendance_scope` accepts `all` (default), `exhibitor_employee`, or `visitor`. `all` includes known attendance evidence. `exhibitor_employee` includes dual-identity events. `visitor` returns visitor-only events and excludes exhibitor-employee evidence. Evidence is combined per event across matched people before filtering. Each event returns the complete `attendance_identity` array. ## OpenAPI ````yaml /openapi.json get /external/personnel/events/by-name openapi: 3.1.0 info: title: Lensmor API version: 0.27.0 description: >- Lensmor Event Intelligence API for event discovery, exhibitor research, personnel lookup, credits, and profile matching. license: name: Lensmor Terms of Service url: https://www.lensmor.com/terms servers: - url: https://platform.lensmor.com security: - bearerAuth: [] tags: - name: Credits description: Inspect the credit balance available to the authenticated API key owner. - name: Actions description: Preflight access and credit-sensitive actions before executing them. - name: Events description: Discover, inspect, score, rank, and unlock trade show event records. - name: Exhibitors description: Search and inspect exhibiting companies and their related events. - name: Personnel description: >- Browse event personnel, related events, LinkedIn activity, and outreach content. - name: Contacts description: Search contacts and run asynchronous email or phone unlock workflows. - name: Profile Matching description: Apply a buyer profile to rank events and recommend exhibitors. paths: /external/personnel/events/by-name: get: tags: - Personnel summary: Search personnel related events by name description: >- Find paginated, deduplicated events for up to 50 personnel records with the exact full name. Matching ignores case and surrounding whitespace. Date filters use event start dates; `date_start_from` defaults to `2026-01-01`. A non-empty result consumes `50` credits; an empty result consumes `0`. Up to `10 requests` can run concurrently per user. `attendance_scope` accepts `all` (default), `exhibitor_employee`, or `visitor`. `all` includes known attendance evidence. `exhibitor_employee` includes dual-identity events. `visitor` returns visitor-only events and excludes exhibitor-employee evidence. Evidence is combined per event across matched people before filtering. Each event returns the complete `attendance_identity` array. operationId: searchPersonnelEventsByName parameters: - name: person_name in: query required: true description: >- Exact full name. Matching is case-insensitive after trimming; partial and fuzzy matching are not used. schema: type: string minLength: 1 maxLength: 200 example: Jane Doe - $ref: '#/components/parameters/PersonnelAttendanceScopeQuery' - name: date_start_from in: query required: false description: >- Inclusive event start-date lower bound. Defaults to `2026-01-01` when omitted. schema: type: string format: date default: '2026-01-01' example: '2026-01-01' - name: date_start_to in: query required: false description: Inclusive event start-date upper bound. Omit it for no upper bound. schema: type: string format: date example: '2026-12-31' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/PageSize' - $ref: '#/components/parameters/CallSource' responses: '200': description: >- Paginated events, a paid-feature business error, or a per-user concurrency business error content: application/json: schema: oneOf: - $ref: '#/components/schemas/PersonnelRelatedEventPage' - $ref: '#/components/schemas/FeatureUnavailableBusinessError' - $ref: '#/components/schemas/ConcurrencyLimitBusinessError' examples: success: value: items: - id: '501' eventId: '139574' name: Retail Technology Expo 2026 nickname: null description: Retail technology event url: https://example.com/events/retail-technology-expo-2026 dateStart: '2026-10-01' dateEnd: '2026-10-03' venue: Las Vegas Convention Center city: Las Vegas region: NV country: United States exhibitorCount: 950 hasVisitors: true sponsorMatchStarred: 0 image: null dataSource: Lensmor attendance_identity: - visitor total: 1 page: 1 pageSize: 20 totalPages: 1 hasMore: false concurrencyLimitExceeded: value: code: 429 message: Too many concurrent requests for this endpoint errorKey: USER_CONCURRENCY_LIMIT_EXCEEDED data: null details: null traceId: trace-123 featureUnavailable: value: code: 400 message: >- This feature is not available to free users, please upgrade to continue errorKey: USER_HAS_NO_FEATURE traceId: 2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': description: Active paid subscription required content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': $ref: '#/components/responses/RateLimited' x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://platform.lensmor.com/external/personnel/events/by-name?person_name=Jane%20Smith&attendance_scope=visitor&page=1&pageSize=20' \ --header 'Authorization: Bearer ' components: parameters: PersonnelAttendanceScopeQuery: name: attendance_scope in: query required: false description: >- Filter events by attendance identities for the matched person or people. Defaults to `all`. `exhibitor_employee` includes events with exhibitor-employee evidence, including events that also have visitor evidence. `visitor` returns visitor-only events and excludes events with exhibitor-employee evidence. Exact-name lookups combine evidence per event across matched personnel before applying this filter. Only `all`, `exhibitor_employee`, and `visitor` are valid; other values, including `null`, return 400. schema: type: string enum: - all - exhibitor_employee - visitor default: all example: visitor Page: name: page in: query description: >- One-based page number. Use `1` for the first page and increment it while `hasMore` is `true`. example: 1 schema: type: integer minimum: 1 default: 1 PageSize: name: pageSize in: query description: >- Maximum number of records requested per page. The shared default is `20` and the shared upper limit is `100`; individual endpoints can document a lower maximum. example: 20 schema: type: integer minimum: 1 maximum: 100 default: 20 CallSource: name: x-call-source in: header required: false schema: type: string enum: - api - agent description: >- Identify the caller as `api` or `agent` for usage attribution. Defaults to `api` when omitted. example: api schemas: PersonnelRelatedEventPage: type: object required: - items - total - page - pageSize - totalPages - hasMore properties: items: type: array items: $ref: '#/components/schemas/PersonnelRelatedEventItem' description: Records returned on the current page or in the current batch. total: type: integer description: Total matching records across all pages. page: type: integer description: One-based page number returned. pageSize: type: integer description: Maximum records requested for this page. totalPages: type: integer description: Total pages available for the current query. hasMore: type: boolean description: Whether another result page is available. additionalProperties: true description: Paginated person-related events with attendance identities. FeatureUnavailableBusinessError: type: object required: - code - message - errorKey - traceId properties: code: type: integer const: 400 description: >- Business code returned in an HTTP 200 response for this paid-feature guard. message: type: string description: >- Human-readable explanation suitable for logs or user-facing error handling. errorKey: type: string const: USER_HAS_NO_FEATURE description: >- Stable machine-readable error key for a feature unavailable to free users. traceId: type: string description: Request trace identifier to include in support or incident reports. details: description: >- Optional structured error details; normally omitted for this business guard. additionalProperties: false description: >- HTTP 200 business-error envelope returned when an active paid subscription is required. ConcurrencyLimitBusinessError: type: object required: - code - message - errorKey - data - details - traceId properties: code: type: integer const: 429 description: >- Numeric or symbolic code that identifies the response or business condition. message: type: string description: >- Human-readable explanation suitable for logs or user-facing error handling. errorKey: type: string const: USER_CONCURRENCY_LIMIT_EXCEEDED description: Stable machine-readable error key for branching and analytics. data: type: 'null' description: >- Optional structured business-error data; `null` when no extra data is available. details: type: 'null' description: >- Optional structured error details; `null` when no extra details are available. traceId: type: string description: Request trace identifier to include in support or incident reports. additionalProperties: false description: >- Business error returned when a user exceeds the endpoint's concurrent-request limit. ApiError: type: object required: - code - message - errorKey - traceId properties: code: type: integer description: >- Numeric or symbolic code that identifies the response or business condition. message: type: string description: >- Human-readable explanation suitable for logs or user-facing error handling. errorKey: type: string description: Stable machine-readable error key for branching and analytics. traceId: type: string description: Request trace identifier to include in support or incident reports. details: description: >- Optional structured business or validation context. Omitted when the error has no additional details. description: Shared error envelope returned by public Lensmor API endpoints. PersonnelRelatedEventItem: allOf: - $ref: '#/components/schemas/EventItem' - type: object required: - attendance_identity properties: attendance_identity: type: array items: type: string enum: - exhibitor_employee - visitor description: >- Complete attendance identities for the matched personnel at this event. Exact-name lookups combine evidence across matched personnel records before filtering. Scope filtering does not trim the returned identity array. example: - exhibitor_employee - visitor description: >- Event returned by a person reverse lookup with event-scoped attendance identities. EventItem: type: object required: - id - eventId - name properties: id: type: string description: Stable Lensmor identifier for this record. eventId: type: string description: Public event identifier accepted by event-scoped endpoints. name: type: - string - 'null' description: Display name when available. nickname: type: - string - 'null' description: Alternative or shortened event name when available. description: type: - string - 'null' description: Public description when available. url: type: - string - 'null' description: Canonical public website URL when available. dateStart: type: - string - 'null' format: date description: Event start date in ISO `YYYY-MM-DD` format when available. dateEnd: type: - string - 'null' format: date description: Event end date in ISO `YYYY-MM-DD` format when available. venue: type: - string - 'null' description: Event venue name when available. city: type: - string - 'null' description: City associated with the record when available. region: type: - string - 'null' description: Region, state, or province when available. country: type: - string - 'null' description: Country associated with the record when available. exhibitorCount: type: - integer - 'null' description: Known exhibitor count for the event when available. hasVisitors: type: boolean description: >- True when the event currently has registered Visitor data available. This is an availability signal, not proof that the caller has unlocked Visitor access. sponsorMatchStarred: type: integer enum: - 0 - 1 description: Sponsor Match starred state returned by Lensmor. image: type: - string - 'null' description: Public image or logo URL when available. dataSource: type: string const: Lensmor description: Source label for the returned Lensmor record. additionalProperties: true description: >- Shared public event summary used by event lists, search results, and recommendation workflows. responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ApiError' example: code: 400 message: Invalid request errorKey: INVALID_REQUEST traceId: 2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10 Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ApiError' example: code: 401 message: Invalid API key errorKey: INVALID_API_KEY traceId: 2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10 PaymentRequired: description: Insufficient credits content: application/json: schema: $ref: '#/components/schemas/ApiError' example: code: 402 message: Insufficient credits errorKey: INSUFFICIENT_CREDITS traceId: 2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10 RateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' example: code: 429 message: Rate limit exceeded errorKey: RATE_LIMIT_EXCEEDED traceId: 2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Business sk API key description: >- Send the full Business API key from Settings -> API Keys, for example `Authorization: Bearer sk_your_api_key`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.