---
title: "Service status and machine-readable surface directory"
method: GET
path: "/public/status"
tags: ["Public"]
---

# Service status and machine-readable surface directory

`GET /public/status`

## Request

- Base URL: `https://simpledock.ai/api/v1`
- URL: `https://simpledock.ai/api/v1/public/status`
- Auth: none required

Unauthenticated. Returns service status plus absolute URLs for the OpenAPI spec, the MCP endpoint and manifest, llms.txt, and the sitemap. Callable with nothing in hand, so an agent can start here and discover everything else.

## Response `200`

Service is up

- object
  - `data` PublicStatus, required: Service status and a directory of every machine-readable surface.
    - `service` 'simpledock', required
    - `status` 'ok', required
    - `apiVersion` string, required
    - `time` string, date-time
    - `documentation` string, uri
    - `openapi` object
      - `json` string, uri
      - `yaml` string, uri
    - `mcp` object
      - `url` string, uri
      - `transport` 'streamable-http'
      - `protocolVersion` string
      - `manifest` string, uri
    - `agentIndex` object
      - `llmsTxt` string, uri
      - `llmsFullTxt` string, uri
      - `sitemap` string, uri
    - `publicEndpoints` object[]
      - `operationId` string
      - `method` string
      - `path` string
      - `description` string
    - `authenticatedApi` object
      - `base` string, uri
      - `scheme` string
      - `keys` string, uri

## Other responses

- `429`: Rate limited — 60 requests per minute per IP; retry after Retry-After

---

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