---
title: "List up to 50 saved version summaries, or read one snapshot by version"
method: GET
path: "/diagrams/{id}/versions"
---

# List up to 50 saved version summaries, or read one snapshot by version

`GET /diagrams/{id}/versions`

## Request

- Base URL: `https://flowchartai.org/api/v1`
- URL: `https://flowchartai.org/api/v1/diagrams/{id}/versions`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `id` string, required

## Query parameters

- `version` string

## Response `200`

Successful response

- union
  - object
    - `data` object[]
      - `version` string
      - `title` string
      - `created_at` string, date-time
  - object
    - `version` string
    - `title` string
    - `document` NativeDocument
      - `editorKind` 'drawio', required
      - `formatVersion` unknown, required
      - `documentId` string, required
      - `revision` integer, required
      - `diagramType` string, required
      - `pageId` string
      - `xml` string, required: Valid uncompressed mxGraphModel/mxfile XML. Maximum 2 MB / 2,000 objects. No external entities.
    - `created_at` string, date-time

## Other responses

- `400`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `401`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `402`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `403`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `404`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `409`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `413`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `422`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `429`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `502`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.
- `503`: Invalid request, credentials, ownership, allowance, conflict, budget, or unavailable upstream. A 429 response includes Retry-After.

---

[API](https://skmtc.dev/flowchartai/apis/flowchartai-developer-api.md) · [All operations](https://skmtc.dev/flowchartai/apis/flowchartai-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flowchartai/apis/flowchartai-developer-api/revisions/914d81b5d394?raw)