---
title: "Get service OpenAPI definition"
method: GET
path: "/services/{service}/openapi"
tags: ["service"]
---

# Get service OpenAPI definition

`GET /services/{service}/openapi`

Returns the OpenAPI 3.1 specification for the service, describing all handlers and their request/response schemas.

## Path parameters

- `service` string, required

## Response `200`

OpenAPI 3.1 specification document describing the service's API

- unknown

## Other responses

- `400` — Bad request
- `404` — Not found
- `405` — Method not allowed
- `409` — Conflict
- `500` — Internal server error

## Changes

> 8 revisions in range; 1 could not be searched.

- **2026-01-30** `059a44500a5c` — 3 info
  - added the non-success response with the status `405`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `503`

[Change history](https://skmtc.dev/restatedev/apis/admin-api/changes/services/:service/openapi/get.md)

---

[API](https://skmtc.dev/restatedev/apis/admin-api.md) · [All operations](https://skmtc.dev/restatedev/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/restatedev/admin-api/revisions/5361f4818c71/schema)