---
title: "List events for an app"
method: GET
path: "/v2/apps/{app_id}/events"
tags: ["Events"]
---

# List events for an app

`GET /v2/apps/{app_id}/events`

## Request

- Base URL: `https://api.tenjin.com`
- URL: `https://api.tenjin.com/v2/apps/{app_id}/events`
- Auth: HTTP bearer

## Path parameters

- `app_id` string, uuid, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Events

- EventListDocument
  - `data` EventResource[], required
    - `id` string, uuid, required
    - `type` 'event', required
    - `attributes` object, required
      - `name` string, nullable, required: Display name of the event
      - `event` string, nullable, required: Name of the event as the app sends it
  - `links` Links, required
    - `self` string, uri, required: URL of this request
    - `first` string, uri: URL of the first page of a list
    - `prev` string, uri: URL of the previous page of a list
    - `next` string, uri: URL of the next page of a list
    - `last` string, uri: URL of the last page of a list
  - `meta` PageMeta, required
    - `count` integer, required: Number of items on all pages
    - `per_page` integer, required: Number of items per page

## Other responses

- `400`: A param is missing or invalid, a record is not found, or the request cannot be served
- `401`: Missing or invalid credentials, or no access to the requested data
- `403`: Invalid token, or the user's role does not allow the request
- `498`: Expired token, or a token with an invalid signature

---

[API](https://skmtc.dev/tenjin/apis/campaign-management-api.md) - [All operations](https://skmtc.dev/tenjin/apis/campaign-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tenjin/apis/campaign-management-api/revisions/e3cae1a03a92?raw)
