> ## 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 > Return a paginated, deduplicated event list for up to 50 personnel records whose full name exactly matches the supplied name. This endpoint requires an active paid user. A non-empty result consumes 50 credits; an empty result consumes 0 credits. At most 10 requests can run concurrently for one user. ## OpenAPI ````yaml /openapi.json get /external/personnel/events/by-name openapi: 3.1.0 info: title: Lensmor API version: 0.25.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: >- Return a paginated, deduplicated event list for up to 50 personnel records whose full name exactly matches the supplied name. This endpoint requires an active paid user. A non-empty result consumes 50 credits; an empty result consumes 0 credits. At most 10 requests can run concurrently for one user. operationId: searchPersonnelEventsByName parameters: - name: person_name in: query required: true description: >- Exact personnel full name. Matching is case-insensitive and ignores leading and trailing whitespace. schema: type: string minLength: 1 maxLength: 200 example: Jane Smith - name: date_start_from in: query required: false description: >- Inclusive lower bound for the event start date. Defaults to the current date when omitted. schema: type: string format: date example: '2026-08-10' - name: date_start_to in: query required: false description: >- Inclusive upper bound for the event start date. Omit 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, or a business-error envelope when the per-user concurrency limit is exceeded content: application/json: schema: oneOf: - $ref: '#/components/schemas/EventPage' - $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 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 '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' components: parameters: Page: name: page in: query schema: type: integer minimum: 1 default: 1 PageSize: name: pageSize in: query schema: type: integer minimum: 1 maximum: 100 default: 20 CallSource: name: x-call-source in: header required: false schema: type: string enum: - api - agent schemas: EventPage: type: object required: - items - total - page - pageSize - totalPages - hasMore properties: items: type: array items: $ref: '#/components/schemas/EventItem' total: type: integer page: type: integer pageSize: type: integer totalPages: type: integer hasMore: type: boolean additionalProperties: true ConcurrencyLimitBusinessError: type: object required: - code - message - errorKey - data - details - traceId properties: code: type: integer const: 429 message: type: string errorKey: type: string const: USER_CONCURRENCY_LIMIT_EXCEEDED data: type: 'null' details: type: 'null' traceId: type: string additionalProperties: false ApiError: type: object required: - code - message - errorKey - traceId properties: code: type: integer message: type: string errorKey: type: string traceId: type: string EventItem: type: object required: - id - eventId - name properties: id: type: string eventId: type: string name: type: - string - 'null' nickname: type: - string - 'null' description: type: - string - 'null' url: type: - string - 'null' dateStart: type: - string - 'null' format: date dateEnd: type: - string - 'null' format: date venue: type: - string - 'null' city: type: - string - 'null' region: type: - string - 'null' country: type: - string - 'null' exhibitorCount: type: - integer - 'null' 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' dataSource: type: string const: Lensmor additionalProperties: true responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ApiError' Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ApiError' PaymentRequired: description: Insufficient credits content: application/json: schema: $ref: '#/components/schemas/ApiError' RateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' 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`. ````