Events list

Search and paginate Lensmor trade show events by category, geography, date, quality score, and other filters for event discovery workflows.

Browse events currently available through the Lensmor API.

Use this endpoint when you need a paginated event catalog with basic filters such as keyword, country, city, and date range.

When to use this endpoint

Use GET /external/events/list for broad discovery and browsing experiences:

• Build an event search or browsing page.
• Let users filter events by geography or date.
• Retrieve stable event identifiers before calling detail, exhibitor, personnel, or unlock endpoints.
• Create an initial shortlist before using profile matching or ranking endpoints.

If you already have a company profile and want relevance-ranked results, start with Apply profile and get recommended events instead.

Endpoint

GET /external/events/list

Authentication

See Authentication

Success status code

200 OK

Query parameters

Name	Required	Type	Notes
page	No	integer	Defaults to 1.
pageSize	No	integer	Defaults to 20; maximum 100.
keyword	No	string	Event name or keyword search.
country	No	string	Country filter.
city	No	string	City filter.
date_start_from	No	ISO date string	Inclusive lower bound for event date filtering.
date_start_to	No	ISO date string	Inclusive upper bound for event date filtering.
event_type	No	string[]	Event type filter. Comma-separated input is supported. Known values include In-person, conference_led, expo_led, hybrid.
quality	No	string[]	Quality label filter. Comma-separated input is supported. Known values include Verified, Standard.

Request example

curl "https://platform.lensmor.com/external/events/list?keyword=retail&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

Filter by geography and date

curl "https://platform.lensmor.com/external/events/list?country=United%20States&city=New%20York&date_start_from=2026-01-01&date_start_to=2026-03-31&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

Filter by multi-value fields

event_type and quality accept array-style inputs from clients and comma-separated inputs in query strings.

curl "https://platform.lensmor.com/external/events/list?event_type=conference_led,expo_led&quality=Verified,Standard&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

Response example

{
  "items": [
    {
      "id": "26855",
      "eventId": "26855",
      "name": "CES 2025",
      "nickname": "Consumer Electronics Show 2025",
      "description": "CES 2025, taking place in Las Vegas, NV from January 7-10...",
      "url": "https://www.ces.tech/",
      "dateStart": "2025-01-07",
      "dateEnd": "2025-01-10",
      "venue": "Las Vegas Convention Center",
      "city": "Las Vegas",
      "region": "Nevada",
      "country": "United States",
      "exhibitorCount": 3259,
      "image": "https://example.com/ces-image.png",
      "dataSource": "Lensmor"
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20,
  "totalPages": 3,
  "hasMore": true
}

Response fields

Field	Description
items	Event records for the requested page.
id	Internal Lensmor event identifier (string). Currently identical to eventId.
eventId	Public event identifier. Use this value when passing to other endpoints that accept event_id. Currently identical to id.
name	Canonical event name.
nickname	Optional short name or common alias.
description	Short event description when available.
url	Source or official event URL when available.
dateStart, dateEnd	Event date range.
venue, city, region, country	Location metadata.
exhibitorCount	Known exhibitor count when available.
dataSource	Source category for the returned record (e.g. "Lensmor", "local_import"). Do not hard-code checks against specific values.
total, page, pageSize, totalPages, hasMore	Pagination metadata.

Error responses

• 401 Unauthorized
• 429 Too Many Requests

Notes

• This endpoint returns a paginated event catalog rather than recommendation-specific results.
• Pagination fields follow the shared conventions described in Pagination conventions.
• Results are not guaranteed to be relevance-ranked unless a keyword or filter strongly narrows the result set.
• id and eventId currently return the same value. Use eventId when passing to event-scoped endpoints.
• event_type and quality filters must match actual values in the database (e.g. In-person, conference_led for event type; Verified, Standard for quality). Invalid values return an empty result set rather than an error.
• Filter values are applied to the event catalog, but summary list items may still omit or return null for some classification fields. Fetch event detail when you need the full classification shape.