---
title: "List events"
full: true
_openapi:
  method: GET
  toc: []
  structuredData:
    headings: []
    contents:
      - content: "Lists org-defined events and their property schemas"
_apiData:
  document: "https://reloop.sh/api/workflow/openapi/json"
  operationData: [{"path":"/api/workflow/v1/events/","method":"get"}]
  parameterList: [{"name":"page","type":"string | number","required":false,"description":"Page number","location":"query","defaultValue":1,"minimum":1},{"name":"limit","type":"string | number","required":false,"description":"Events per page","location":"query","defaultValue":50,"minimum":1,"maximum":100}]
  responseMap: {"200":{"description":"Response for status 200","schema":{"events":[{"id":"evt_123456789","organizationId":"org_123456789","name":"User signed up","key":"trigger.user.signed_up","description":"Fired when an account is created","properties":[{"id":"evtp_123456789","name":"plan","propertyType":"string","required":true,"defaultValue":null,"description":"The plan they picked","createdAt":"2026-03-23T10:00:00.000Z","updatedAt":"2026-03-23T10:00:00.000Z"}],"createdAt":"2026-03-23T10:00:00.000Z","updatedAt":"2026-03-23T10:00:00.000Z"}],"total":1,"page":1,"limit":50}},"401":{"description":"Response for status 401","schema":{"message":"Authentication required"}}}
  codeSamples:
    - id: node
      lang: javascript
      label: Node.js
      source: |-
        import { Reloop } from "reloop-email";
        
        const reloop = new Reloop({ apiKey: "rl_123456789" });
        
        const { events, eventError } = await reloop.events.list({ page: 1, limit: 20 });
        if (eventError) throw eventError;
    - id: curl
      lang: bash
      label: cURL
      source: |-
        curl -X GET "https://reloop.sh/api/workflow/v1/events?page=1&limit=20" \
          -H "x-api-key: rl_123456789"
    - id: python
      lang: python
      label: Python
      source: |-
        import requests
        
        res = requests.get(
            "https://reloop.sh/api/workflow/v1/events?page=1&limit=20",
            headers={"x-api-key": "rl_123456789"},
        )
        res.raise_for_status()
        print(res.json())
---
> For the complete documentation index, see [llms-docs.txt](/llms-docs.txt) or the site index [llms.txt](/llms.txt). Full docs corpus: [llms-full-docs.txt](/llms-full-docs.txt). Prefer markdown URLs (append `.md`) for agent consumption. Product skill: [skill.md](/skill.md).


{/* This file was generated by the OpenAPI doc generator. Do not edit this file directly. Run `bun run generate:api-docs` to regenerate. */}

<APIPage />