Event brief details

Fetch lightweight Lensmor event summaries for UI cards, quick previews, and background refreshes without loading full event detail metadata.

Fetch a lightweight summary for a single event.

Use this endpoint when you need a compact event snapshot instead of a list response or a ranking result.

When to use this endpoint

Use GET /external/events/brief for lightweight UI cards, quick previews, or background refreshes where full detail metadata is not necessary.

Prefer Event detail when your product needs category, topic, pricing, coordinate, or historical metadata.

Endpoint

GET /external/events/brief

Authentication

See Authentication

Success status code

200 OK

Query parameters

Name	Required	Type	Notes
event_id	Yes	string	Event identifier.

Request example

curl "https://platform.lensmor.com/external/events/brief?event_id=139574" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

Response example

{
  "event": {
    "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"
  },
  "summary": {
    "attendeeCount": 40000,
    "exhibitorCount": 950,
    "topCategories": [],
    "dataFreshness": "database_snapshot"
  }
}

Response fields

Field	Description
event	Compact event identity and location object.
event.id, event.eventId	Event identifiers returned with the event.
event.name, event.description, event.url	Basic display metadata.
event.dateStart, event.dateEnd	Event date range.
event.venue, event.city, event.region, event.country	Location fields.
event.exhibitorCount	Known exhibitor count when available.
summary.attendeeCount	Attendee count when available.
summary.exhibitorCount	Exhibitor count repeated in the summary block for compact display.
summary.topCategories	Top categories when available.
summary.dataFreshness	Freshness/source label for the snapshot.

Error responses

• 400 Bad Request
• 401 Unauthorized
• 404 Not Found
• 429 Too Many Requests

Notes

• This is a lightweight snapshot endpoint.
• topCategories is currently returned as an empty array by the live service.
• The endpoint is read-only and does not consume credits.