---
title: "List available API specifications"
method: GET
path: "/specs"
tags: ["discovery"]
---

# List available API specifications

`GET /specs`

Returns a list of region-specific OpenAPI specifications for the Pydantic Logfire API. Use the `openapi_url` of each entry to fetch the full per-region specification.

## Response `200`

Available region-specific API specifications.

- SpecList
  - `specs` SpecRef[], required — Available API specifications, one per region.
    - `region` string, required — Short region identifier.
    - `name` string, required — Human-readable name for this API.
    - `openapi_url` string, uri, required — URL of the OpenAPI specification for this API.
    - `base_url` string, uri, required — Base URL at which this API is served.
    - `documentation_url` string, uri — URL of human-readable documentation for this API.

## Other responses

- `400` — Bad request — the request was malformed (for example, an invalid `Idempotency-Key` header).
- `404` — The requested resource was not found.
- `405` — Method not allowed. This API is read-only; only `GET`, `HEAD`, and `OPTIONS` are accepted.
- `429` — Too many requests — the advertised rate-limit budget has been exceeded.
- `default` — Error response.

---

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