# Retrieve an event.

Endpoint: GET /events/{eventId}
Version: v3
Security: oauth2

## Path parameters:

  - `eventId` (string, required)
    Id of the event.

## Response 200 fields (text/plain):

  - `id` (string)
    Gets the event id which acts as the primary key in the database.

  - `name` (string,null, required)
    Gets or sets the event name.

  - `description` (string,null)
    Gets or sets the event description.

  - `startTime` (string, required)
    Gets or sets the event start time.

  - `endTime` (string,null)
    Gets or sets the event end time.

  - `eventTypeId` (integer, required)
    Gets the event type id which is defined by Willow, e.g. CalendarEvent, WeatherForecast, UtilityBill, ….

  - `eventSourceId` (string,null)
    Gets the name of the source system, which is for informational purposes.

  - `externalId` (string,null)
    Gets an Id linking it to the source system, facilitating updates and deletes.

  - `payload` (string,null, required)
    Gets or sets a JSON string containing type-specific values.

  - `payloadVersion` (string,null, required)
    Gets or sets a version for the payload to assist in the deserialization of the payload.

  - `scalarValue` (number,null)
    Gets or sets a double value that may be stored to complement the Payload value.

  - `twinId` (string,null, required)
    Gets the id of the twin that is a reference to to an existing space, or equipment twin.

  - `locations` (string,null)
    Gets or sets a JSON string with the expanded location ancestors for the twinId.

  - `createdDate` (string, required)
    Gets or sets the date the event was created in the system.

  - `lastModifiedDate` (string, required)
    Gets or sets the date the event was last modified in the system.

## Response 404 fields (text/plain):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)