---
title: "Lists integration retros, newest first, optionally filtered by status."
method: GET
path: "/admin/retros"
tags: ["admin"]
---

# Lists integration retros, newest first, optionally filtered by status.

`GET /admin/retros`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/admin/retros`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `status` string

## Response `200`

One page of retros, newest first

- RetroListResponse: Response for `GET /admin/retros`.
  - `retros` RetroRecord[], required: One page of retros, newest first.
    - `created_at` string, required: RFC 3339 submission timestamp.
    - `id` string, required: Retro id (UUID v4).
    - `key_id` string, required: API key id that submitted it.
    - `payload` unknown, required
    - `status` string, required: Triage status, one of [`RETRO_STATUSES`].
  - `total` integer, required: Total stored retros (across all pages).

## Other responses

- `400`: Invalid limit, offset or status filter
- `401`: Missing or wrong admin token

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)