---
title: "Get event by id"
method: GET
path: "/api/events/{eventId}"
tags: ["Events"]
---

# Get event by id

`GET /api/events/{eventId}`

Returns an event with the specified id.

## Path parameters

- `eventId` string, uuid, required

## Response `200`

OK

- Event — Object representing an event. **Note:** As an event can be of different type, not all properties listed here are included in all event as it depends on it's type.
  - `id` string, uuid — The identifier of the event.
  - `type` string, nullable
  - `level` string, nullable
  - `timestamp` string, date-time — The time of the event.
  - `subject` string, nullable — The subject of the event. A short summary of what has happened.
  - `message` string, nullable — The message of the event. A more detailed description of what has happened.
  - `application` string, nullable
  - `organizationId` string, uuid — The identifier of the organization.
  - `createdBy` Creator — Object representing the creator of an object.
    - `type` string, nullable — Type of the creator. Can be `Unknown`, `User`, `EdgeNode`, `EdgeNodeRegistrar` or `Anonymous`.
    - `id` string, uuid — The identifier of the creator.
    - `name` string, nullable — The name of the creator.
  - `userId` string, uuid, nullable — Optional. For events that are related to a user this property contains that user id.
  - `userName` string, nullable — Optional. For events that are related to a user this property contains that user name.
  - `edgenodeId` string, uuid, nullable — Optional. For events that are related to a node this property contains that node id.
  - `edgenodeName` string, nullable — Optional. For events that are related to a node this property contains that node name.
  - `softwareVersion` string, nullable — Optional. For events that are related to a node and software version is of interest, this property contains that software version.
  - `flowId` string, uuid, nullable — Optional. For events that are related to a flow this property contains that flow id.
  - `parameterId` string, nullable — Optional. For events that are related to a parameter this property contains that parameter id.
  - `flowName` string, nullable — Optional. For events that are related to a flow this property contains that flow name.
  - `flowVersion` string, nullable — Optional. For events that are related to a flow this property contains that flow version.
  - `moduleId` string, uuid, nullable — Optional. For events that are related to a module this property contains that module id.
  - `moduleVersion` string, nullable — Optional. For events that are related to a module this property contains that module version.
  - `moduleName` string, nullable — Optional. For events that are related to a module this property contains that module name.
  - `role` string, nullable
  - `state` string, nullable — Optional. For events that are related to a node state this property contains that state. Available values are `online`, `offline`.
  - `lastHeardFrom` string, date-time — Optional. For events that are related to a node state this property contains the last time the node was heard from.
  - `flowDefinitionId` string, uuid, nullable — Optional. For events that are related to a flow definition this property contains that flow definition id.
  - `flowDeploymentId` string, uuid, nullable — Optional. For events that are related to a flow deployment this property contains that flow deployment id.
  - `flowDefinitionName` string, nullable — Optional. For events that are related to a flow definition this property contains that flow definition name.
  - `priority` integer — The priority of the event as an integer.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `503` — Service Unavailable

---

[API](https://skmtc.net/crosser/apis/edge-director-api.md) · [All operations](https://skmtc.net/crosser/apis/edge-director-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crosser/edge-director-api/versions/746b3f44e69d/schema)