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

# List events

> List the latest event log entries, in descending order.



## OpenAPI

````yaml /openapi/cluster-api-v2.json get /events/
openapi: 3.0.0
info:
  description: >-
    REST API for querying information about CockroachDB cluster health, nodes,
    ranges,

    sessions, and other meta information. For additional details, see
    cockroachlabs.com/docs/stable/cluster-api.
  title: CockroachDB v2 API
  license:
    name: Business Source License
  version: '2.0'
  x-logo:
    url: https://www.cockroachlabs.com/docs/images/cockroachlabs-logo-170.png
    backgroundColor: '#FFFFFF'
    altText: Cockroach Labs logo
servers:
  - url: https://localhost/api/v2
  - url: http://localhost/api/v2
security: []
paths:
  /events/:
    get:
      summary: List events
      description: List the latest event log entries, in descending order.
      operationId: listEvents
      parameters:
        - description: >-
            Type of events to filter for (e.g., "create_table"). Only one event
            type can be specified at a time.
          name: type
          in: query
          schema:
            type: string
        - description: >-
            Filter for events with this targetID. Only one targetID can be
            specified at a time.
          name: targetID
          in: query
          schema:
            type: integer
        - description: Maximum number of results to return in this call.
          name: limit
          in: query
          schema:
            type: integer
        - description: Continuation token for results after a past limited run.
          name: offset
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: Events response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/eventsResponse'
      x-codeSamples:
        - lang: Shell + Curl
          source: |-
            curl --request GET \
              --url 'https://localhost/api/v2/events/?type=SOME_STRING_VALUE&targetID=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&offset=SOME_INTEGER_VALUE'
components:
  schemas:
    eventsResponse:
      type: object
      title: Response for listEvents.
      properties:
        events:
          type: array
          items:
            $ref: '#/components/schemas/EventsResponse_Event'
          x-go-name: Events
        next:
          description: >-
            The continuation token, for use in the next paginated call in the
            `offset`

            parameter.
          type: integer
          format: int64
          x-go-name: Next
      x-go-package: github.com/cockroachdb/cockroach/pkg/server
    EventsResponse_Event:
      type: object
      properties:
        event_type:
          description: The type of event (e.g., "create_table", "drop_table".
          type: string
          x-go-name: EventType
        info:
          description: |-
            Detailed information for the event. The contents vary
            depending on the event.
          type: string
          x-go-name: Info
        reporting_id:
          description: Reporting ID for this event.
          type: integer
          format: int64
          x-go-name: ReportingID
        target_id:
          description: Target for this event.
          type: integer
          format: int64
          x-go-name: TargetID
        timestamp:
          description: The time at which the event occurred.
          type: string
          format: date-time
          x-go-name: Timestamp
        unique_id:
          description: A unique identifier for this event.
          type: array
          items:
            type: integer
            format: uint8
          x-go-name: UniqueID
      x-go-package: github.com/cockroachdb/cockroach/pkg/server/serverpb

````