> ## Documentation Index
> Fetch the complete documentation index at: https://hmis-docs.derrickmugabwa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference overview

> Interactive reference for the implemented HMIS API.

The HMIS API is versioned under `/api/v1` and uses Laravel Sanctum bearer tokens.

Select an endpoint to inspect its request and response schema, generate code examples, or try it against your configured HMIS API origin.

<Info>
  The playground targets the HMIS staging API. Never use real clinical data or paste a production token into a shared browser session.
</Info>

## Authentication

Create dedicated integration tokens from the super-admin **Integration API tokens** page. Each endpoint requires the specific Sanctum ability shown in its reference. Tokens are entered interactively in the playground and are not stored in this documentation.

<Warning>
  Do not expose a production HMIS API directly to the public internet for playground testing. Use a protected staging or demo environment with sanitized data and HTTPS.
</Warning>