---
title: "Export a published version"
method: GET
path: "/api/projects/{projectId}/specs/{specId}/versions/{versionId}/export"
tags: ["API Specs"]
---

# Export a published version

`GET /api/projects/{projectId}/specs/{specId}/versions/{versionId}/export`

## Request

- Base URL: `https://api.routebase.dev`
- URL: `https://api.routebase.dev/api/projects/{projectId}/specs/{specId}/versions/{versionId}/export`
- Auth: API key in header `X-API-Key`

Returns a published version as a downloadable OpenAPI document. A published
version is frozen, so the same call returns the same bytes forever, which makes
it safe to generate clients from in a build.

## Path parameters

- `ProjectId` string, uuid, required
- `SpecId` string, uuid, required
- `VersionId` string, uuid, required

## Query parameters

- `SpecFormat` string

## Headers

- `X-RB-Region` string

## Response `200`

The specification document as a file.

- string

## Other responses

- `401`: The API key is missing, invalid, expired or revoked. A US organization calling without `X-RB-Region: us` also lands here, because the request reached the wrong region.
- `403`: The key is valid but lacks the permission or the project scope for this call. A scoped key is also refused on organization level operations by design.
- `404`: The resource does not exist, or it belongs to another organization or project. Both cases answer the same way on purpose, so the API cannot be used to probe for foreign identifiers.
- `429`: The rate limit was exceeded. The `Retry-After` header gives the seconds to wait.

---

[API](https://skmtc.dev/routebase/apis/routebase-public-api.md) · [All operations](https://skmtc.dev/routebase/apis/routebase-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/routebase/apis/routebase-public-api/revisions/7187df489f27?raw)