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

# List all events

> Returns all events, sorted by creation date (newest first). If no parameters are provided, results are paginated in pages of 100.



## OpenAPI

````yaml api-reference/anode/flatpeak-api-spec-anode.json GET /events
openapi: 3.0.3
info:
  description: Flatpeak API
  version: 2025-09-14.anode
  title: Flatpeak API
  termsOfService: https://flatpeak.com/legal
  contact:
    name: Technical Support
    email: support@flatpeak.com
    url: https://flatpeak.com/contact
  license:
    name: Apache 2.0
    url: https://flatpeak.com/legal
servers:
  - url: https://api.flatpeak.com
    description: Location
security: []
tags:
  - name: Consumption
    description: Consumption operations
  - name: Customers
    description: Customer operations
  - name: Devices
    description: Device operations
  - name: Meters
    description: Meter readings operations
  - name: Events
    description: Events operations
  - name: Login
    description: Bearer auth token operations
  - name: Connect
    description: Connect operations
  - name: Locations
    description: Location operations
  - name: Rates
    description: Rates operations
  - name: Costs
    description: Consumption cost calculations
  - name: Schedules
    description: Consumption schedules
  - name: Tariffs
    description: Tariff operations
  - name: Slots
    description: Slots operations
externalDocs:
  description: Location documentation
  url: https://docs.flatpeak.com
paths:
  /events:
    parameters: []
    get:
      tags:
        - Events
      summary: List all events
      description: >-
        Returns all events, sorted by creation date (newest first). If no
        parameters are provided, results are paginated in pages of 100.
      operationId: get-events
      parameters:
        - $ref: '#/components/parameters/event_type'
        - $ref: '#/components/parameters/starting_after'
        - $ref: '#/components/parameters/ending_before'
        - $ref: '#/components/parameters/limit'
        - schema:
            type: string
            example: loc_641b90b758fb8e6293716e40
          in: query
          name: object_id
          description: Filter events by Flatpeak identifier such as a location ID.
      responses:
        '200':
          $ref: '#/components/responses/EventList'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '429':
          $ref: '#/components/responses/429'
      security:
        - bearerAuth: []
components:
  parameters:
    event_type:
      name: event_type
      in: query
      required: false
      schema:
        type: string
      description: Type of event.
    starting_after:
      schema:
        type: string
      in: query
      name: starting_after
      description: >-
        Specifies a cursor for pagination use; provider_id defines the place in
        the list. To retrieve the next page in the list include starting_after
        where ID is the last ID in the currently retrieved list.
    ending_before:
      schema:
        type: string
      in: query
      name: ending_before
      description: >-
        Specifies a cursor for pagination use; provider_id defines the place in
        the list. To retrieve the previous page in the list, include
        ending_before, which is the first ID in the currently retrieved list.
    limit:
      schema:
        type: integer
      in: query
      name: limit
      description: >-
        A limit on the number of objects to be returned. Can range between 1 and
        100, and the default is 30.
  responses:
    '403':
      description: 403 forbidden
      content:
        application/json:
          schema:
            type: object
            x-examples:
              Example:
                message: Bad credentials
            properties:
              object:
                type: string
                example: error
                x-stoplight:
                  id: gria4ysjd9zhk
                default: error
              type:
                type: string
                x-stoplight:
                  id: 7mhtfljidnqcu
                example: invalid_request
                default: invalid_request
              code:
                type: string
                x-stoplight:
                  id: sy7ljpdy5wdes
                example: access_denied
                default: access_denied
              time_created:
                type: string
                x-stoplight:
                  id: 84d5biv9dfbc9
                format: date-time
                example: '2025-01-01T00:00:00Z'
            required:
              - object
              - type
              - code
          examples: {}
    '404':
      description: 404 response
      content:
        application/json:
          schema:
            type: object
            x-examples:
              Example:
                message: Not Found
            properties:
              object:
                type: string
                example: error
                x-stoplight:
                  id: qyc690tqd4dnh
                default: error
              type:
                type: string
                x-stoplight:
                  id: 6sog2aaccgb59
                example: invalid_request
                default: invalid_request
              code:
                type: string
                x-stoplight:
                  id: 6l9jrgodwxi0c
                example: not_found
                default: not_found
              time_created:
                type: string
                x-stoplight:
                  id: 1ywndy1nsshcz
                example: '2025-01-01T00:00:00Z'
                format: date-time
          examples: {}
    '429':
      description: 429 Too many requests
      content:
        application/json:
          schema:
            type: object
            properties:
              object:
                type: string
                x-stoplight:
                  id: irkmp11gg6sjx
                example: error
                default: error
              type:
                type: string
                x-stoplight:
                  id: u0gq12cizam3d
                default: rate_limit
                example: rate_limit
              code:
                type: string
                x-stoplight:
                  id: uh7x9404d4w3q
                default: too_many_requests
                example: too_many_requests
              message:
                type: string
                x-stoplight:
                  id: 9z8h79l1coblc
                default: Too many requests. Please retry after a short delay.
                example: Too many requests. Please retry after a short delay.
              time_created:
                type: string
                x-stoplight:
                  id: ea7o3uvdojrtc
                format: date-time
                default: '2026-01-29T17:11:52Z'
                example: '2026-01-29T17:11:52Z'
            required:
              - object
              - type
              - code
              - message
    EventList:
      description: ''
      content:
        application/json:
          schema:
            type: object
            x-examples:
              '':
                object: list
                url: /events
                has_more: false
                data:
                  - id: evt_b6e31325b57d4fb79917be19afeb1fc4
                    object: event
                    api_version: '2022-05-21'
                    time_created: 1530291411
                    data:
                      live_mode: false
                      object: device
                      id: dev_607c124e99c1401ca7fc3a5ca5ff9501
                      mac: 00-00-5e-00-53-af
                      account_id: acc_c85e9f90aa18454487b50d3c1785ed4e
                      customer_id: cus_3090a6232d754c9a8936272376989781
                      provider_id: prv_3090a6232d754c9a8936272376989781
                      location_id: loc_65bb076f362848378137f055139becb1
                      description: Kitchen Fridge Freezer
                      time_created: '2022-01-24T14:15:22Z'
                      last_seen: '2022-03-22T11:12:21Z'
                      hardware_profile:
                        make: Samsung
                        type: Fridge
                        model: SRVQ1342
                        wattage_in: 3000
                        wattage_out: 0
                      postal_address:
                        address_line1: Science and Industry Museum
                        address_line2: Liverpool Road
                        city: Manchester
                        state: Lancashire
                        post_code: M34FP
                        country_code: GB
                      geo_location:
                        latitude: '-77.52907766250239'
                        longitude: '167.1522246611749'
                      tariff:
                        - direction: inbound
                          valid_from: '2021-05-05T00:03:00Z'
                          valid_to: '2021-05-05T04:30:00Z'
                          cost:
                            rate: 4.998
                            confidence: 1
                          renewable:
                            share: 10
                            confidence: 0.9
                          grid:
                            load: 2
                            confidence: 0.8
                        - direction: inbound
                          valid_from: '2021-05-05T04:30:00Z'
                          valid_to: '2021-05-06T00:30:00Z'
                          cost:
                            rate: 15.897
                            confidence: 1
                          renewable:
                            share: 30
                            confidence: 0.7
                          grid:
                            load: 4
                            confidence: 0.6
                  - id: evt_784ddeffc4484e25b4a492e96f7cd1b2
                    object: event
                    api_version: '2022-05-21'
                    time_created: '2022-01-24T14:15:22Z'
                    data:
                      live_mode: false
                      object: device
                      id: dev_607c124e99c1401ca7fc3a5ca5ff9501
                      mac: 00-00-5e-00-53-af
                      account_id: acc_c85e9f90aa18454487b50d3c1785ed4e
                      customer_id: cus_3090a6232d754c9a8936272376989781
                      provider_id: prv_3090a6232d754c9a8936272376989781
                      location_id: loc_65bb076f362848378137f055139becb1
                      description: Kitchen Fridge
                      time_created: '2022-01-24T14:15:22Z'
                      last_seen: '2022-03-22T11:12:21Z'
                      hardware_profile:
                        make: Samsung
                        type: Fridge
                        model: SRVQ1342
                        wattage_in: 3000
                        wattage_out: 0
                      postal_address:
                        address_line1: Science and Industry Museum
                        address_line2: Liverpool Road
                        city: Manchester
                        state: Lancashire
                        post_code: M34FP
                        country_code: GB
                      geo_location:
                        latitude: '-77.52907766250239'
                        longitude: '167.1522246611749'
                      tariff:
                        - direction: inbound
                          valid_from: '2021-05-05T00:03:00Z'
                          valid_to: '2021-05-05T04:30:00Z'
                          cost:
                            rate: 4.998
                            confidence: 1
                          renewable:
                            share: 10
                            confidence: 0.9
                          grid:
                            load: 2
                            confidence: 0.8
                        - direction: inbound
                          valid_from: '2021-05-05T04:30:00Z'
                          valid_to: '2021-05-06T00:30:00Z'
                          cost:
                            rate: 15.897
                            confidence: 1
                          renewable:
                            share: 30
                            confidence: 0.7
                          grid:
                            load: 4
                            confidence: 0.6
            properties:
              object:
                type: string
                description: Represents the object’s type. i.e. `list`.
                example: list
              url:
                type: string
                description: Represents the URL slug for the object.
                example: /events
              has_more:
                type: boolean
                description: Is set to `true` if more objects are available.
              data:
                type: array
                items:
                  $ref: '#/components/schemas/Event'
          examples: {}
  schemas:
    Event:
      type: object
      x-examples: {}
      properties:
        id:
          type: string
          example: evt_65e42b7827c0526548432b9f
          description: Flatpeak unique event id.
        object:
          type: string
          example: event
          description: Represents the object’s type, i.e. event.
        time_created:
          type: string
          description: Time when the object was created, in UTC.
          example: '2022-01-24T14:15:22Z'
        type:
          type: string
          example: device.create
          description: Flatpeak object type in the payload. For example `customer.create`.
        data:
          $ref: '#/components/schemas/Device'
    Device:
      type: object
      x-examples: {}
      description: This object represents a device or another asset of a compatible type.
      title: Device
      x-tags:
        - Devices
      properties:
        id:
          type: string
          description: Flatpeak unique object `id`.
          example: dev_63a6087272941ef077a8fd3e
          readOnly: true
        object:
          type: string
          description: Represents the object’s type.
          example: device
          readOnly: true
        live_mode:
          type: boolean
          x-stoplight:
            id: 49pa8oln5zly4
          description: >-
            Has the value true if the object exists in live mode or the value
            false if the object exists in test mode.
        reference_id:
          type: string
          description: >-
            A reference that is meaningful to you, for example, an ID from your
            system.
          example: DEV1234567890
          x-stoplight:
            id: gcnayduh1z16f
          readOnly: true
        last_seen:
          type: string
          description: Timestamp of when the device has last queried the service.
          example: '2022-03-22T11:12:21Z'
          format: date-time
        time_created:
          type: string
          description: Time when the object was created, in UTC.
          example: '2022-01-24T14:15:22Z'
        account_id:
          type: string
          description: Flatpeak account ID.
          example: acc_661677911f2197045e6cf1b1
          x-stoplight:
            id: gcnayduh1z16f
          readOnly: true
      required:
        - id
        - object
        - live_mode
        - reference_id
        - time_created
        - account_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authenticate with `bearer` you obtained from
        [authentication](/api-reference/anode/authentication) endpoint.

````