Skip to main content

Event

An event can be represented by a stay, a show, a journey or any insured event containing a place and a date.

idstring

Event ID

Example: ev_XQ4peN02vn7r
namestring

The name of the event/venue

Possible values: <= 50 characters

Example: Best Band Live
placestring

Location/Place name of the venue

Possible values: <= 50 characters

Example: Staples Center
tourstring

Name of the show tour

Possible values: <= 50 characters

event_typestring

Category of the event. (e.g show, festival, accommodation...)

Possible values: <= 30 characters

addressstring

Possible values: <= 128 characters

Example: 123 rue de Rivoli
zipcodestring

Possible values: <= 10 characters

Example: 75001
citystring

Possible values: <= 50 characters

Example: Paris
countrystring

ISO 3166 country code (2 chars)

Possible values: >= 2 characters and <= 2 characters

Example: FR
regionstring

ISO 3166-2 subdivision code. Optional, but strongly recommended for countries spanning several timezones (US, CA, AU, BR, MX, RU, ID, KZ, CD, MN, CL, EC, ES, PT, GL, NZ, KI, FM), where the country code alone is not enough to determine the event timezone.

Possible values: <= 6 characters

Example: TX
date_startdate-time

Event start date (ISO 8601)

Example: 2025-02-14T15:19:21Z
date_enddate-time

Event end date (ISO 8601)

Example: 2025-02-14T15:19:21Z
latfloat

Latitude

lngfloat

Longitude

timezonetimezone

Event Timezone

Example: Europe/Paris
external_event_idstring

Vendor's event ID

Example: 12345
statusstring

Possible values: [enabled, cancelled, draft]

Event
{
  "id": "ev_XQ4peN02vn7r",
  "name": "Best Band Live",
  "place": "Staples Center",
  "tour": "string",
  "event_type": "string",
  "address": "123 rue de Rivoli",
  "zipcode": "75001",
  "city": "Paris",
  "country": "FR",
  "region": "TX",
  "date_start": "2025-02-14T15:19:21Z",
  "date_end": "2025-02-14T15:19:21Z",
  "lat": 0,
  "lng": 0,
  "timezone": "Europe/Paris",
  "external_event_id": "12345",
  "status": "enabled"
}