---
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
        - `response_data` string
        - `response_http_header` DatastoreHttpHeader
      - `created_at` string
      - `deleted_at` string
      - `event_type` string
      - `metadata` DatastoreMetadata
        - `data` integer[] — 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

## Other responses

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

## Changes

- **2024-07-15** (v3) `f48524f80fda` — 1 info
  - added the optional property `allOf[subschema #2]/data/allOf[subschema #2]/content/items/metadata/max_retry_seconds` to the response with the `200` status
- **2024-03-26** (v3) `28d285e4302c` — 4 warning, 1 info
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `400` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `401` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `404` status
  - …1 more
- **2024-02-20** (v3) `6ef49682c1c0` — 1 info
  - added the new optional `query` request parameter `direction`
- **2024-02-20** (v3) `81dc59314306` — 1 warning
  - deleted the `query` request parameter `direction`
- **2024-02-08** (v3) `52443da83eda` — 1 info
  - added the new optional `query` request parameter `direction`

[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/de665d0e2fc3/schema)