Skip to content

API Reference

Your Kite server documents its own API. Because it’s generated from the code that’s running, it always matches your server’s version: no endpoint you don’t have, none missing.

URL What it is
https://<your server>/openapi The interactive reference: every endpoint, with examples.
https://<your server>/openapi/json The OpenAPI spec, for code generators and API tools.

The server prints the reference’s URL when it starts.

The API reference served by a Kite server at /openapi

Endpoints are grouped by what they act on: apps, payment links, transfers and so on. Each shows its body, its responses, and a request in the language you pick.

Create a payment link in the reference: its body fields, a curl example and the response

Every endpoint needs authentication. To try requests from the page, choose rootKey as the auth type and paste your root key; signed API-key requests are easier to make with the SDK, which signs them for you.

The reference is on by default. Two environment variables control it:

  • KITE_ENABLE_OPENAPI_UI_SPECS=false turns off both /openapi and /openapi/json.
  • KITE_ENABLE_OPENAPI_UI_PROVIDER=swagger serves Swagger UI instead of Scalar.

To get the spec without running a server, such as in CI, print it from a checkout of the server:

Terminal window
bun run spec > kite.json