---
title: "Export simulation run results"
method: GET
path: "/v1/runs/{run_id}/export.{fmt}"
tags: ["Export"]
---

# Export simulation run results

`GET /v1/runs/{run_id}/export.{fmt}`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/runs/{run_id}/export.{fmt}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Export a simulation run in the requested format.

| Format | Content-Type | Dependency |
|--------|-------------|------------|
| `csv`  | text/csv    | stdlib — always available |
| `xlsx` | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | `openpyxl` |
| `pdf`  | application/pdf | `fpdf2` |
| `json` | application/json | stdlib — always available |

If the optional dependency is not installed the endpoint returns **503**.

## Path parameters

- `run_id` string, uuid, required: Simulation run UUID
- `fmt` string, required: Export format: csv | xlsx | pdf | json

## Response `200`

Export file bytes

- unknown

## Other responses

- `400`: Unsupported format
- `404`: Run not found
- `422`: Validation Error
- `503`: Export dependency not installed

---

[API](https://skmtc.dev/codna/apis/algenta-api.md) · [All operations](https://skmtc.dev/codna/apis/algenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codna/apis/algenta-api/revisions/35d30f84a5df?raw)