---
title: "List recent runs"
method: GET
path: "/runs"
tags: ["Runs"]
---

# List recent runs

`GET /runs`

## Request

- Base URL: `https://seogeoaeo.ai/api/v1`
- URL: `https://seogeoaeo.ai/api/v1/runs`
- Auth: HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

Newest first.

- object
  - `runs` RunSummary[]
    - `id` string
    - `toolId` string
    - `slug` string
    - `toolVersion` string
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled'
    - `creditsCharged` integer
    - `priceVersion` string
    - `errorClass` string, nullable
    - `errorMessage` string, nullable
    - `inputSummary` string, nullable
    - `createdAt` string, date-time
    - `startedAt` string, date-time, nullable
    - `finishedAt` string, date-time, nullable

## Other responses

- `400`: Error envelope.
- `401`: Error envelope.
- `429`: Error envelope.

---

[API](https://skmtc.dev/seogeoaeo/apis/seogeoaeo-ai-api.md) · [All operations](https://skmtc.dev/seogeoaeo/apis/seogeoaeo-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seogeoaeo/apis/seogeoaeo-ai-api/revisions/e6f4e073e822?raw)