--- title: "Retrieve an event" method: GET path: "/events/{id}" tags: ["Events"] --- # Retrieve an event `GET /events/{id}` Retrieve event details by their id ## Path parameters - `id` string, required ## Response `200` Retrieve the event details - union - SubscriptionCreated - `id` string, required — Unique identifier for the webhook event - `topic` 'subscription.created', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `subscription.created` event - `subscription` string, required — ID of the subscription that was created - `lead` string — ID of the lead that was converted to this subscription (if applicable) - SubscriptionConfirmed - `id` string, required — Unique identifier for the webhook event - `topic` 'subscription.confirmed', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `subscription.confirmed` event - `subscription` string, required — ID of the subscription that was confirmed - SubscriptionActivated - `id` string, required — Unique identifier for the webhook event - `topic` 'subscription.activated', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `subscription.activated` event - `subscription` string, required — ID of the subscription that was active - SubscriptionEnded - `id` string, required — Unique identifier for the webhook event - `topic` 'subscription.ended', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `subscription.ended` event - `subscription` string, required — ID of the subscription that was ended - SubscriptionTerminated - `id` string, required — Unique identifier for the webhook event - `topic` 'subscription.terminated', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `subscription.terminated` event - `subscription` string, required — ID of the subscription that was terminated (cancelled) - InvoiceCreated - `id` string, required — Unique identifier for the webhook event - `topic` 'invoice.created', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `invoice.created` event - `invoice` string, required — ID of the invoice that was created - `subscription` string, required — ID of the subscription the invoice belongs to - InvoicePaid - `id` string, required — Unique identifier for the webhook event - `topic` 'invoice.paid', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `invoice.paid` event - `invoice` string, required — ID of the invoice that was paid - `subscription` string, required — ID of the subscription the invoice belongs to - InvoicePaymentFailed - `id` string, required — Unique identifier for the webhook event - `topic` 'invoice.payment_failed', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `invoice.payment_failed` event - `invoice` string, required — ID of the invoice whose payment attempt failed - `subscription` string, required — ID of the subscription the invoice belongs to - InvoiceVoided - `id` string, required — Unique identifier for the webhook event - `topic` 'invoice.voided', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `invoice.voided` event - `invoice` string, required — ID of the invoice that was voided - `subscription` string, required — ID of the subscription the invoice belongs to - `voiding_invoice` string, required — ID of the offsetting voiding invoice - InvoiceUncollectible - `id` string, required — Unique identifier for the webhook event - `topic` 'invoice.uncollectible', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `invoice.uncollectible` event - `invoice` string, required — ID of the invoice that was marked uncollectible - `subscription` string, required — ID of the subscription the invoice belongs to - MeterOrderCreated - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.created', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.created` event - `meter_order` string, required — ID of the smart meter order that was created - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderPlaced - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.placed', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.placed` event - `meter_order` string, required — ID of the smart meter order that was placed with the meter provider - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderCheckSubmitted - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.check_submitted', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.check_submitted` event - `meter_order` string, required — ID of the smart meter order whose check request was submitted - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderCheckReviewed - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.check_reviewed', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.check_reviewed` event - `meter_order` string, required — ID of the smart meter order whose check was reviewed by the meter provider - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderScheduled - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.scheduled', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.scheduled` event - `meter_order` string, required — ID of the smart meter order that was scheduled for installation - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderInstalled - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.installed', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.installed` event - `meter_order` string, required — ID of the smart meter order whose meter was installed - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderActivated - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.activated', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.activated` event - `meter_order` string, required — ID of the smart meter order whose meter was activated - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderBlocked - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.blocked', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.blocked` event - `meter_order` string, required — ID of the smart meter order that was blocked - `subscription` string, required — ID of the subscription the smart meter order belongs to - MeterOrderCancelled - `id` string, required — Unique identifier for the webhook event - `topic` 'meter_order.cancelled', required — Event type identifier - `timestamp` union, required — Timestamp when the event was created - string, date-time - string - `context` object, required — The context of the `meter_order.cancelled` event - `meter_order` string, required — ID of the smart meter order that was cancelled - `subscription` string, required — ID of the subscription the smart meter order belongs to ## Other responses - `400` — The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). - `401` — The client must authenticate itself to get the requested response. - `402` — A higher pricing plan is required to access the resource. - `403` — The client does not have the necessary permissions to access the resource. - `404` — The server can't find the requested resource. - `405` — The request method is not allowed. - `409` — The request could not be completed due to a conflict mainly due to unique constraints. - `422` — The request was well-formed but was unable to be followed due to semantic errors. - `429` — The client has sent too many requests. - `500` — The server has encountered a situation it doesn't know how to handle. --- [API](https://skmtc.dev/nomos/apis/nomos-api.md) · [All operations](https://skmtc.dev/nomos/apis/nomos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nomos/nomos-api/revisions/da60ad83e92f/schema)