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.
Exhibitor event search
Search events directly by exhibitor company name.
Endpoint
POST /external/exhibitors/search-events
Authentication
See Authentication
Success status code
201 Created
Request body
| Field | Required | Type | Notes |
|---|
company_name | Yes | string | Company name to search for. |
page | No | integer | Defaults to 1. |
pageSize | No | integer | Defaults to 20, max 100. |
Response body
Top-level fields
| Field | Type | Notes |
|---|
items | object[] | Event summaries enriched with matching exhibitor stubs. |
total | integer | Total matched events. |
page | integer | Current page number. |
pageSize | integer | Page size used for this response. |
totalPages | integer | 0 when total is 0. |
hasMore | boolean | true when another page exists. |
items[] fields
| Field | Type | Notes |
|---|
| All event summary fields | object | Same event summary shape as GET /external/events/list items[]. |
matchedExhibitors | object[] | Matching exhibitors for this event page row. |
items[].matchedExhibitors[] fields
| Field | Type | Notes |
|---|
id | string | Lensmor exhibitor identifier. |
companyName | string | Matching exhibitor company name. |
Response example
{
"items": [
{
"id": "123",
"eventId": "139574",
"name": "Shoptalk",
"nickname": null,
"description": null,
"url": "https://example.com",
"dateStart": "2026-03-25",
"dateEnd": "2026-03-28",
"venue": "Convention Center",
"city": "Las Vegas",
"region": "Nevada",
"country": "United States",
"exhibitorCount": 250,
"image": null,
"matchedExhibitors": [
{
"id": "456",
"companyName": "Acme"
}
]
}
],
"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.402 Payment Required when the caller lacks sufficient credits for the search charge.
Notes
- A successful search consumes
50 credits.
- No matches return an empty success response rather than
404.
