---
title: "Export the current state of a specification"
method: GET
path: "/api/projects/{projectId}/specs/{specId}/export"
tags: ["API Specs"]
---

# Export the current state of a specification

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

## Request

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

Returns the working state of a specification as OpenAPI, which is the draft as
it stands in the designer right now. To export something stable, export a
published version instead.

## Path parameters

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

## Query parameters

- `SpecFormat` string

## Headers

- `X-RB-Region` string

## Response `200`

The specification document.

- 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)