Skip to main content

​
Events list

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.

​
Endpoint

GET /external/events/list

​
Authentication

See Authentication

​
Success status code

200 OK

​
Query parameters

NameRequiredTypeNotes
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20; maximum 100.
keywordNostringEvent name or keyword search.
countryNostringCountry filter.
cityNostringCity filter.
date_start_fromNoISO date stringInclusive lower bound for event date filtering.
date_start_toNoISO date stringInclusive upper bound for event date filtering.

​
Response example

{
  "items": [
    {
      "id": "123",
      "eventId": "139574",
      "name": "NRF 2026",
      "nickname": null,
      "description": "Retail industry event",
      "url": "https://example.com/events/nrf-2026",
      "dateStart": "2026-01-12",
      "dateEnd": "2026-01-15",
      "venue": "Javits Center",
      "city": "New York",
      "region": "NY",
      "country": "United States",
      "exhibitorCount": 950,
      "image": null,
      "dataSource": "database"
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20,
  "totalPages": 3,
  "hasMore": true
}

​
Error responses

  • 401 Unauthorized

​
Notes

  • This endpoint returns a paginated event catalog rather than recommendation-specific results.
  • Pagination fields follow the shared conventions described in Pagination conventions.
  • When neither date_start_from nor date_start_to is supplied, the runtime defaults to events starting from yesterday through one year from now.
  • List-summary items intentionally omit attendeeCount and personnelCount.