Get an OpenAPI spec version by its ID

Available in MCP

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

specSlugstringRequired

Slug of the OpenAPI specification

versionIdstringRequired

The unique ID of the OpenAPI specification version

Responses

200

OK

application/json

objectstring · enumRequired

The object type, which is always "openapi-spec-version"

Possible values:

idstringRequired

Unique identifier

createdAtstring · date-timeOptional

Date of creation

urlstring · uri · max: 2048Required

URL where the specification is accessible.

404

No matching OpenAPI specification version found

application/json

get/orgs/{organizationId}/openapi/{specSlug}/versions/{versionId}

GET /v1/orgs/{organizationId}/openapi/{specSlug}/versions/{versionId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "object": "openapi-spec-version",
  "id": "text",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "url": "https://example.com",
  "urls": {
    "location": "https://example.com"
  }
}