Events

List events

Browse the Lensmor event catalog with keyword, geography, date, event-type, quality, Sponsor Match, and Visitor-data filters.

Use this endpoint for broad discovery, search pages, and the first step of an event workflow. Returned id and eventId values can be passed to event detail, exhibitor, personnel, scoring, ranking, recommendation, and access-unlock endpoints.

Filters narrow the catalog and pagination is one-based. Use sponsor_match_starred=1 or 0 for Sponsor Match state and has_visitors=1 or 0 for Visitor-data availability. Returned hasVisitors is an availability signal; it does not mean the caller has unlocked Visitor data. No matches return 200 OK with an empty items array.

GET

external

events

list

List events

curl --request GET \
  --url https://platform.lensmor.com/external/events/list \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform.lensmor.com/external/events/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.lensmor.com/external/events/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.lensmor.com/external/events/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform.lensmor.com/external/events/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": "8458",
      "eventId": "26855",
      "name": "CES 2025",
      "nickname": "Consumer Electronics Show 2025",
      "description": "Consumer technology trade show in Las Vegas.",
      "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,
      "hasVisitors": true,
      "sponsorMatchStarred": 0,
      "image": "https://example.com/ces-image.png",
      "dataSource": "Lensmor"
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20,
  "totalPages": 3,
  "hasMore": true
}

{
  "code": 400,
  "message": "Invalid request",
  "errorKey": "INVALID_REQUEST",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 401,
  "message": "Invalid API key",
  "errorKey": "INVALID_API_KEY",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 429,
  "message": "Rate limit exceeded",
  "errorKey": "RATE_LIMIT_EXCEEDED",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

Authorizations

Authorization

string

header

required

Send the full Business API key from Settings -> API Keys, for example Authorization: Bearer sk_your_api_key.

Query Parameters

page

integer

default:1

One-based page number. Use 1 for the first page and increment it while hasMore is true.

Required range: x >= 1

pageSize

integer

default:20

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.

Required range: 1 <= x <= 100

keyword

string

Search event names and related event text by keyword.

Maximum string length: 200

country

string

Filter events by country name.

Maximum string length: 100

city

string

Filter events by city name.

Maximum string length: 100

date_start_from

string<date>

Inclusive lower bound for the event start date in YYYY-MM-DD format.

date_start_to

string<date>

Inclusive upper bound for the event start date in YYYY-MM-DD format.

event_type

string[]

Filter by one or more event-type labels. Comma-separated input is supported.

quality

string[]

Filter by one or more quality labels. Comma-separated input is supported.

Filter by Sponsor Match starred state: 1 for starred or 0 for not starred.

Available options:

0,

1

has_visitors

enum<integer>

Filter by registered Visitor-data availability: 1 when available or 0 when unavailable.

Available options:

0,

1

Response

Paginated events

Standard paginated collection of public event summaries.

items

object[]

required

Records returned on the current page or in the current batch.

Show child attributes

total

integer

required

Total matching records across all pages.

page

integer

required

One-based page number returned.

pageSize

integer

required

Maximum records requested for this page.

totalPages

integer

required

Total pages available for the current query.

hasMore

boolean

required

Whether another result page is available.

List events

curl --request GET \
  --url https://platform.lensmor.com/external/events/list \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform.lensmor.com/external/events/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.lensmor.com/external/events/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.lensmor.com/external/events/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform.lensmor.com/external/events/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": "8458",
      "eventId": "26855",
      "name": "CES 2025",
      "nickname": "Consumer Electronics Show 2025",
      "description": "Consumer technology trade show in Las Vegas.",
      "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,
      "hasVisitors": true,
      "sponsorMatchStarred": 0,
      "image": "https://example.com/ces-image.png",
      "dataSource": "Lensmor"
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20,
  "totalPages": 3,
  "hasMore": true
}

{
  "code": 400,
  "message": "Invalid request",
  "errorKey": "INVALID_REQUEST",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 401,
  "message": "Invalid API key",
  "errorKey": "INVALID_API_KEY",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 429,
  "message": "Rate limit exceeded",
  "errorKey": "RATE_LIMIT_EXCEEDED",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

Credits

Actions

Events

Exhibitors

Personnel

Contacts

Profile Matching

List events

Authorizations

Query Parameters

Response