> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an event

> Retrieve event details by their id



## OpenAPI

````yaml /openapi/openapi.edison.json get /events/{id}
openapi: 3.0.0
info:
  title: Nomos API
  version: 2026-01-29.edison
servers:
  - url: http://localhost
    description: test
security: []
tags:
  - name: Plans
  - name: Leads
  - name: Subscriptions
  - name: Customers
  - name: Usage
  - name: Prices
  - name: Invoices
  - name: Smart Meter Orders
  - name: Grid Fee Reductions
  - name: Market Partners
  - name: Events
  - name: Authentication
paths:
  /events/{id}:
    get:
      tags:
        - Events
      summary: Retrieve an event
      description: Retrieve event details by their id
      parameters:
        - schema:
            type: string
            example: evt_<id>
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Retrieve the event details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '400':
          description: >-
            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).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrBadRequest'
        '401':
          description: The client must authenticate itself to get the requested response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrUnauthorized'
        '402':
          description: A higher pricing plan is required to access the resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrPaymentRequired'
        '403':
          description: >-
            The client does not have the necessary permissions to access the
            resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrForbidden'
        '404':
          description: The server can't find the requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrNotFound'
        '405':
          description: The request method is not allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrMethodNotAllowed'
        '409':
          description: >-
            The request could not be completed due to a conflict mainly due to
            unique constraints.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrConflict'
        '422':
          description: >-
            The request was well-formed but was unable to be followed due to
            semantic errors.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrUnprocessableEntity'
        '429':
          description: The client has sent too many requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrTooManyRequests'
        '500':
          description: >-
            The server has encountered a situation it doesn't know how to
            handle.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrInternalServerError'
      security:
        - Bearer: []
components:
  schemas:
    Event:
      oneOf:
        - $ref: '#/components/schemas/subscription.created'
        - $ref: '#/components/schemas/subscription.confirmed'
        - $ref: '#/components/schemas/subscription.activated'
        - $ref: '#/components/schemas/subscription.ended'
        - $ref: '#/components/schemas/subscription.terminated'
        - $ref: '#/components/schemas/invoice.created'
        - $ref: '#/components/schemas/invoice.paid'
        - $ref: '#/components/schemas/invoice.payment_failed'
        - $ref: '#/components/schemas/invoice.voided'
        - $ref: '#/components/schemas/invoice.uncollectible'
      discriminator:
        propertyName: topic
        mapping:
          subscription.created:
            $ref: '#/components/schemas/subscription.created'
          subscription.confirmed:
            $ref: '#/components/schemas/subscription.confirmed'
          subscription.activated:
            $ref: '#/components/schemas/subscription.activated'
          subscription.ended:
            $ref: '#/components/schemas/subscription.ended'
          subscription.terminated:
            $ref: '#/components/schemas/subscription.terminated'
          invoice.created:
            $ref: '#/components/schemas/invoice.created'
          invoice.paid:
            $ref: '#/components/schemas/invoice.paid'
          invoice.payment_failed:
            $ref: '#/components/schemas/invoice.payment_failed'
          invoice.voided:
            $ref: '#/components/schemas/invoice.voided'
          invoice.uncollectible:
            $ref: '#/components/schemas/invoice.uncollectible'
    ErrBadRequest:
      type: object
      properties:
        code:
          type: string
          enum:
            - BAD_REQUEST
          description: The error code related to the status code.
          example: BAD_REQUEST
        message:
          type: string
          description: A human readable message describing the issue.
          example: 'invalid_type in ''end'': Required'
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/BAD_REQUEST
      required:
        - code
        - message
        - requestId
        - docs
    ErrUnauthorized:
      type: object
      properties:
        code:
          type: string
          enum:
            - UNAUTHORIZED
          description: The error code related to the status code.
          example: UNAUTHORIZED
        message:
          type: string
          description: A human readable message describing the issue.
          example: Invalid or malformed token
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/UNAUTHORIZED
      required:
        - code
        - message
        - requestId
        - docs
    ErrPaymentRequired:
      type: object
      properties:
        code:
          type: string
          enum:
            - PAYMENT_REQUIRED
          description: The error code related to the status code.
          example: PAYMENT_REQUIRED
        message:
          type: string
          description: A human readable message describing the issue.
          example: Payment required
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/PAYMENT_REQUIRED
      required:
        - code
        - message
        - requestId
        - docs
    ErrForbidden:
      type: object
      properties:
        code:
          type: string
          enum:
            - FORBIDDEN
          description: The error code related to the status code.
          example: FORBIDDEN
        message:
          type: string
          description: A human readable message describing the issue.
          example: You are not allowed to access this resource
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/FORBIDDEN
      required:
        - code
        - message
        - requestId
        - docs
    ErrNotFound:
      type: object
      properties:
        code:
          type: string
          enum:
            - NOT_FOUND
          description: The error code related to the status code.
          example: NOT_FOUND
        message:
          type: string
          description: A human readable message describing the issue.
          example: Resource not found
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/NOT_FOUND
      required:
        - code
        - message
        - requestId
        - docs
    ErrMethodNotAllowed:
      type: object
      properties:
        code:
          type: string
          enum:
            - METHOD_NOT_ALLOWED
          description: The error code related to the status code.
          example: METHOD_NOT_ALLOWED
        message:
          type: string
          description: A human readable message describing the issue.
          example: Method not allowed
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/METHOD_NOT_ALLOWED
      required:
        - code
        - message
        - requestId
        - docs
    ErrConflict:
      type: object
      properties:
        code:
          type: string
          enum:
            - CONFLICT
          description: The error code related to the status code.
          example: CONFLICT
        message:
          type: string
          description: A human readable message describing the issue.
          example: Resource already exists
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/CONFLICT
      required:
        - code
        - message
        - requestId
        - docs
    ErrUnprocessableEntity:
      type: object
      properties:
        code:
          type: string
          enum:
            - UNPROCESSABLE_ENTITY
          description: The error code related to the status code.
          example: UNPROCESSABLE_ENTITY
        message:
          type: string
          description: A human readable message describing the issue.
          example: >-
            invalid_enum_value in 'status': Invalid enum value. Expected
            'pending' | 'active' | 'ended'
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/UNPROCESSABLE_ENTITY
      required:
        - code
        - message
        - requestId
        - docs
    ErrTooManyRequests:
      type: object
      properties:
        code:
          type: string
          enum:
            - TOO_MANY_REQUESTS
          description: The error code related to the status code.
          example: TOO_MANY_REQUESTS
        message:
          type: string
          description: A human readable message describing the issue.
          example: Wait 30 seconds before retrying.
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: https://docs.nomos.energy/api-references/errors/TOO_MANY_REQUESTS
      required:
        - code
        - message
        - requestId
        - docs
    ErrInternalServerError:
      type: object
      properties:
        code:
          type: string
          enum:
            - INTERNAL_SERVER_ERROR
          description: The error code related to the status code.
          example: INTERNAL_SERVER_ERROR
        message:
          type: string
          description: A human readable message describing the issue.
          example: Internal Server Error
        requestId:
          type: string
          description: The request id to be used for debugging and error reporting.
          example: 37a04f8f-e791-491c-81e1-86cd304649bb
        docs:
          type: string
          description: The docs related to the error code.
          example: >-
            https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR
      required:
        - code
        - message
        - requestId
        - docs
    subscription.created:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - subscription.created
          description: Event type identifier
          example: subscription.created
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            subscription:
              type: string
              description: ID of the subscription that was created
              example: sub_<id>
            lead:
              type: string
              description: >-
                ID of the lead that was converted to this subscription (if
                applicable)
              example: lead_<id>
          required:
            - subscription
          description: The context of the `subscription.created` event
      required:
        - id
        - topic
        - timestamp
        - context
    subscription.confirmed:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - subscription.confirmed
          description: Event type identifier
          example: subscription.confirmed
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            subscription:
              type: string
              description: ID of the subscription that was confirmed
              example: sub_<id>
          required:
            - subscription
          description: The context of the `subscription.confirmed` event
      required:
        - id
        - topic
        - timestamp
        - context
    subscription.activated:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - subscription.activated
          description: Event type identifier
          example: subscription.activated
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            subscription:
              type: string
              description: ID of the subscription that was active
              example: sub_<id>
          required:
            - subscription
          description: The context of the `subscription.activated` event
      required:
        - id
        - topic
        - timestamp
        - context
    subscription.ended:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - subscription.ended
          description: Event type identifier
          example: subscription.ended
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            subscription:
              type: string
              description: ID of the subscription that was ended
              example: sub_<id>
          required:
            - subscription
          description: The context of the `subscription.ended` event
      required:
        - id
        - topic
        - timestamp
        - context
    subscription.terminated:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - subscription.terminated
          description: Event type identifier
          example: subscription.terminated
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            subscription:
              type: string
              description: ID of the subscription that was terminated (cancelled)
              example: sub_<id>
          required:
            - subscription
          description: The context of the `subscription.terminated` event
      required:
        - id
        - topic
        - timestamp
        - context
    invoice.created:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - invoice.created
          description: Event type identifier
          example: invoice.created
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            invoice:
              type: string
              description: ID of the invoice that was created
              example: inv_<id>
          required:
            - invoice
          description: The context of the `invoice.created` event
      required:
        - id
        - topic
        - timestamp
        - context
    invoice.paid:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - invoice.paid
          description: Event type identifier
          example: invoice.paid
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            invoice:
              type: string
              description: ID of the invoice that was paid
              example: inv_<id>
          required:
            - invoice
          description: The context of the `invoice.paid` event
      required:
        - id
        - topic
        - timestamp
        - context
    invoice.payment_failed:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - invoice.payment_failed
          description: Event type identifier
          example: invoice.payment_failed
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            invoice:
              type: string
              description: ID of the invoice whose payment attempt failed
              example: inv_<id>
          required:
            - invoice
          description: The context of the `invoice.payment_failed` event
      required:
        - id
        - topic
        - timestamp
        - context
    invoice.voided:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - invoice.voided
          description: Event type identifier
          example: invoice.voided
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            invoice:
              type: string
              description: ID of the invoice that was voided
              example: inv_<id>
            voiding_invoice:
              type: string
              description: ID of the offsetting voiding invoice
              example: inv_<id>
          required:
            - invoice
            - voiding_invoice
          description: The context of the `invoice.voided` event
      required:
        - id
        - topic
        - timestamp
        - context
    invoice.uncollectible:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the webhook event
          example: evt_<id>
        topic:
          type: string
          enum:
            - invoice.uncollectible
          description: Event type identifier
          example: invoice.uncollectible
        timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: string
          description: Timestamp when the event was created
          example: '2024-03-14T12:00:00Z'
        context:
          type: object
          properties:
            invoice:
              type: string
              description: ID of the invoice that was marked uncollectible
              example: inv_<id>
          required:
            - invoice
          description: The context of the `invoice.uncollectible` event
      required:
        - id
        - topic
        - timestamp
        - context
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````