# LexSelect External API

> External API for the LexSelect platform. All endpoints are mounted under `/api`.

The OpenAPI spec is the full contract: authentication, versioning, errors, request and response schemas.

## Docs

- [OpenAPI spec (JSON)](/api/openapi.json): the complete contract as JSON
- [OpenAPI spec (YAML)](/api/openapi.yaml): the same contract as YAML
- [API reference](/api/docs): interactive reference, rendered with JavaScript
- [Examples & Quick Start (GitHub)](https://github.com/LexSelect/lexselect-api-demo)
- [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457)

## Endpoints

- `GET /api/folders/{folder_id}/sub-documents`: List sub-documents across a folder
- `GET /api/documents`: List files
- `POST /api/documents/upload`: Upload file
- `GET /api/documents/{id}`: Get file
- `DELETE /api/documents/{id}`: Delete file
- `GET /api/documents/{id}/parse`: Get parsed document structure
- `GET /api/documents/{id}/render`: Render document to Markdown or HTML (experimental)
- `GET /api/documents/{id}/processing/latest`: Get processing status
- `GET /api/documents/{id}/processing/latest/pages`: List pages
- `GET /api/usage`: Get current usage and spend
- `GET /api/usage/daily`: Get daily usage