> For the complete documentation index, see [llms.txt](https://docs.sumble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sumble.com/api/openapi.md).

# OpenAPI & client generation

Sumble doesn't publish a first-party SDK. Instead, the API is fully described by an OpenAPI 3 spec, so you can generate a typed client in your language of choice.

## Spec URL

The spec is published and versioned:

```
https://api.sumble.com/openapi.json?version=v9
```

You can also browse it interactively in [Swagger UI](https://api.sumble.com/docs).

## Generate a client

[OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator) is the most widely used generator and supports most languages. For example, to generate a Python client:

```bash
openapi-generator-cli generate \
  -i "https://api.sumble.com/openapi.json?version=v9" \
  -g python \
  -o ./sumble-client
```

Swap `-g python` for `typescript`, `go`, `java`, `csharp`, or any other [supported generator](https://openapi-generator.tech/docs/generators).

Whatever client you generate, authenticate by passing your API key as a Bearer token. See the [Overview](/api/api.md) for details.