Skip to main content

​
Event brief details

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.

​
Endpoint

GET /external/events/brief

​
Authentication

See Authentication

​
Success status code

200 OK

​
Query parameters

NameRequiredTypeNotes
event_idYesstringSupports either Event.eventId or internal Event.id.

​
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,
    "personnelCount": 6200,
    "topCategories": [],
    "dataFreshness": "database_snapshot"
  }
}

​
Error responses

  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found

​
Notes

  • This is a lightweight snapshot endpoint.
  • topCategories is currently returned as an empty array by the live service.
  • summary.attendeeCount and summary.personnelCount fall back to 0 when the event has no personnel relations.