---
title: "Export a session's screenshots as a ZIP"
method: GET
path: "/api/sessions/{sessionId}/export/screenshots"
tags: ["Sessions"]
---

# Export a session's screenshots as a ZIP

`GET /api/sessions/{sessionId}/export/screenshots`

## Request

- Base URL: `https://aximo.autify.com`
- URL: `https://aximo.autify.com/api/sessions/{sessionId}/export/screenshots`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/autify/apis/aximo-api/docs/api/sessions/:sessionId/export/screenshots/get.ts> (a function with typed inputs; its response is checked against the schema)

Streams a ZIP of every step screenshot (`screenshots/step-001.png` or `.jpg`, matching how it was stored) plus
`metadata.csv` (one row per step) and `session.csv` (the run itself). A session
that is still running exports the screenshots captured so far.

The archive streams, so a failure after the response has started can only
abort the connection: the client sees HTTP 200 and a truncated file. Verify
the ZIP's end-of-central-directory record before trusting the download.

## Path parameters

- `sessionId` string, uuid, required

## Query parameters

- `locale` 'en' | 'ja' | 'ko'

## Response `200`

The screenshot archive, streamed without a Content-Length.

## Other responses

- `400`: Invalid sessionId or locale.
- `401`: Missing or invalid API key.
- `403`: The organization's contract has expired, the request comes from outside the organization's IP allowlist, or the API key's user is no longer a member.
- `404`: Session not found in this organization.
- `409`: The session has no screenshots to export.
- `429`: Rate limit exceeded — e.g. the daily session limit was reached for the organization, or too many API requests were sent in a short window (retry after the number of seconds in the `Retry-After` header).
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/autify/apis/aximo-api.md) - [All operations](https://skmtc.dev/autify/apis/aximo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autify/apis/aximo-api/revisions/590722011284?raw)
