---
title: "List all meta events"
method: GET
path: "/v1/projects/{projectID}/meta-events"
tags: ["Meta Events"]
---

# List all meta events

`GET /v1/projects/{projectID}/meta-events`

This endpoint fetches meta events with pagination

## Path parameters

- `projectID` string, required

## Query parameters

- `direction` 'next' | 'prev'
- `endDate` string
- `next_page_cursor` string
- `perPage` integer
- `prev_page_cursor` string
- `sort` string
- `startDate` string

## Response `200`

OK

- object
  - `message` string
  - `status` boolean
  - `data` object
    - `content` ModelsMetaEventResponse[]
      - `attempt` DatastoreMetaEventAttempt
        - `request_http_header` DatastoreHttpHeader, nullable
        - `response_data` string
        - `response_http_header` DatastoreHttpHeader, nullable
      - `created_at` string
      - `deleted_at` string, nullable
      - `event_type` string
      - `metadata` DatastoreMetadata
        - `data` object, nullable — Data to be sent to endpoint.
        - `interval_seconds` integer
        - `max_retry_seconds` integer
        - `next_send_time` string
        - `num_trials` integer — NumTrials: number of times we have tried to deliver this Event to an application
        - `raw` string
        - `retry_limit` integer
        - `strategy` 'linear' | 'exponential' | ''
      - `project_id` string
      - `status` 'Scheduled' | 'Processing' | 'Discarded' | 'Failure' | 'Success' | 'Retry' | ''
      - `uid` string
      - `updated_at` string
    - `pagination` DatastorePaginationData
      - `has_next_page` boolean
      - `has_prev_page` boolean
      - `next_page_cursor` string
      - `per_page` integer
      - `prev_page_cursor` string
      - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

## Changes

- **2026-07-20** (v3) `bae289777c91` — 11 breaking, 12 warning, 5 info
  - the response property `allOf[subschema #2]/data` became nullable for the status `400`
  - the response property `allOf[subschema #2]/data` became nullable for the status `401`
  - the response property `allOf[subschema #2]/data` became nullable for the status `404`
  - the response property `allOf[subschema #2]/data/allOf[subschema #2]/content/items/attempt` became nullable for the status `200`
  - …24 more
- **2026-07-19** (v3) `e171f744d209` — 1 breaking
  - the `allOf[subschema #2]/data/allOf[subschema #2]/content/items/metadata/data` response's property type/format changed from `array`/`` to `object`/`` for status `200`
- **2026-06-18** (v3) `274ed78eabfc` — 1 info
  - added the optional property `allOf[subschema #2]/data/allOf[#/components/schemas/models.PagedResponse]/pagination/allOf[#/components/schemas/datastore.PaginationData]/total` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/getconvoy/apis/convoy-api-reference/changes/v1/projects/:projectID/meta-events/get.md)

---

[API](https://skmtc.dev/getconvoy/apis/convoy-api-reference.md) · [All operations](https://skmtc.dev/getconvoy/apis/convoy-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getconvoy/convoy-api-reference/revisions/df004d06c6c2/schema)