API basics
Base URL, formats and conventions used across the API.
The Knips Public API is a single REST API over HTTPS. Everything speaks JSON.
Base URL
https://api.knips.techAll endpoints are relative to this base and grouped by resource — see Endpoints in the sidebar.
Requests
- Send
Content-Type: application/jsonon any request that has a body. - Request bodies are limited to 1 MB.
- Authenticate every request with your API key.
Responses
- All responses are JSON.
- List endpoints are paged and filterable — see Pagination & filtering.
- Errors follow a consistent shape — see Errors.
Conventions
- Timestamps are in ISO 8601 format, in UTC (e.g.
2026-01-01T12:00:00Z). - Resource identifiers are UUIDs.
