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

# List events

> List the authenticated organization's events, newest first. Results are scoped to what the key's user can open.



## OpenAPI

````yaml /openapi.json get /v1/events
openapi: 3.0.0
info:
  title: Nowadays Public API
  description: Public developer API for reading Nowadays data.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.nowadays.ai
security: []
tags: []
paths:
  /v1/events:
    get:
      tags:
        - Events
      summary: List events
      description: >-
        List the authenticated organization's events, newest first. Results are
        scoped to what the key's user can open.
      operationId: PublicEventsController_list
      parameters:
        - name: page
          required: false
          in: query
          description: 1-based page number.
          schema:
            default: 1
            example: 1
            type: number
        - name: limit
          required: false
          in: query
          description: Results per page (1–100).
          schema:
            default: 20
            example: 20
            type: number
      responses:
        '200':
          description: A page of events, newest first
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedPublicEventsDto'
        '401':
          description: Missing or invalid API key
        '429':
          description: Rate limit exceeded
      security:
        - x-api-key: []
components:
  schemas:
    PaginatedPublicEventsDto:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PublicEventDto'
        page:
          type: number
          description: Current 1-based page.
          example: 1
        limit:
          type: number
          description: Results per page.
          example: 20
        total:
          type: number
          description: Total matching events.
          example: 42
      required:
        - data
        - page
        - limit
        - total
    PublicEventDto:
      type: object
      properties:
        id:
          type: string
          description: Stable public identifier (UUID).
          example: 3f1a2b4c-5d6e-7f80-9a1b-2c3d4e5f6071
        name:
          type: string
          description: Event name.
          example: Annual Conference 2026
        dates:
          description: Event date windows.
          type: array
          items:
            $ref: '#/components/schemas/PublicEventDateDto'
        locations:
          description: Display location strings.
          example:
            - Monterey, CA, USA
          type: array
          items:
            type: string
        numPeople:
          type: number
          description: Expected attendee count.
          example: 120
        status:
          type: string
          description: Event status.
          example: wait_for_proposals
        createdAt:
          type: string
          description: Creation timestamp (ISO 8601).
          example: '2026-01-01T00:00:00.000Z'
      required:
        - id
        - name
        - dates
        - locations
        - numPeople
        - status
        - createdAt
    PublicEventDateDto:
      type: object
      properties:
        startDate:
          type: string
          example: '2026-03-15'
        endDate:
          type: string
          example: '2026-03-17'
        date:
          type: string
          example: '2026-03-15'
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````