---
title: "Export Runs Csv"
method: GET
path: "/api/v1/runs/export.csv"
tags: ["runs"]
---

# Export Runs Csv

`GET /api/v1/runs/export.csv`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/runs/export.csv`
- Auth: none declared

Export run history as CSV — Pro feature (PRD-003 FR-07).

Owner-scoped: only returns runs of agents the caller owns. Free users get
a **402 Pro feature** which the frontend's `withPlanCheck` surfaces via
the `UpgradeModal`.

## Query parameters

- `agent_id` string, uuid, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)