---
title: "List app events"
method: GET
path: "/api/v1/apps/services/{service_id}/events"
tags: ["Raff Apps"]
---

# List app events

`GET /api/v1/apps/services/{service_id}/events`

## Request

- Base URL: `https://api.rafftechnologies.com`
- URL: `https://api.rafftechnologies.com/api/v1/apps/services/{service_id}/events`
- Auth: API key in header `X-API-Key`

The app's timeline, newest first (deploys, settings changes, links, failures).

## Path parameters

- `service_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Events

- object
  - `success` boolean
  - `events` AppEvent[]
    - `id` string
    - `service_id` string, uuid
    - `event_type` string: For example `deploy.live`, `config.updated`, `database.linked`
    - `message` string
    - `metadata` string: Extra details as JSON text, or empty
    - `created_at` string, date-time

## Other responses

- `401`: Authentication required
- `404`: Resource not found

## Changes

- **2026-10-19** `e80a4b1b5024`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/apps/services/:service_id/events/get.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) - [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rafftechnologies/apis/raff-api/revisions/3d30cde0acb4?raw)
