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

# List events

> List the events of a project, newest first.



## OpenAPI

````yaml api-reference/openapi.yaml GET /api/v1/projects/{projectId}/events
openapi: 3.1.0
info:
  title: hooksnode API
  version: '1.0'
  description: |
    Send events to a source, and read and retry events with a workspace API key.
servers:
  - url: https://hooksnode.com
security:
  - bearerAuth: []
tags:
  - name: Ingest
  - name: Projects
  - name: Events
paths:
  /api/v1/projects/{projectId}/events:
    get:
      tags:
        - Events
      summary: List events
      description: List the events of a project, newest first.
      operationId: listEvents
      parameters:
        - $ref: '#/components/parameters/ProjectId'
        - name: page
          in: query
          description: The page, from 1.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          description: Events on each page, 1 to 100. A value out of range gives 20.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: A page of events.
          content:
            application/json:
              schema:
                type: object
                required:
                  - events
                  - total
                  - page
                  - page_size
                properties:
                  events:
                    type: array
                    items:
                      $ref: '#/components/schemas/EventSummary'
                  total:
                    type: integer
                    description: All events in the project.
                  page:
                    type: integer
                  page_size:
                    type: integer
              example:
                events:
                  - id: 1042
                    received_at: '2026-09-24T10:15:02Z'
                    method: POST
                    endpoint: /p/2mJ8kQ4vXw9aB3cD5eF7gH1iK0L
                    status: delivered
                    payload:
                      event: order.paid
                      order_id: '9311'
                total: 1
                page: 1
                page_size: 20
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    ProjectId:
      name: projectId
      in: path
      required: true
      schema:
        type: string
        example: 2mJ8kQ4vXw9aB3cD5eF7gH1iK0L
  schemas:
    EventSummary:
      type: object
      properties:
        id:
          type: integer
          format: int64
        received_at:
          type: string
          format: date-time
        method:
          type: string
          description: The HTTP method, or GMAIL, OUTLOOK, IMAP or POLL.
        endpoint:
          type: string
        status:
          type: string
          enum:
            - received
            - queued
            - delivered
            - failed
            - buffered
        payload:
          description: The body as JSON.
    Error:
      type: object
      properties:
        error:
          type: string
  responses:
    Unauthorized:
      description: The API key is missing or not valid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: No such project or event in this workspace.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A workspace API key. You can also send it in the `X-API-Key` header.

````