Developers
API Documentation
Integrate the Savin Hood tax engine into your own workflows.
Overview
The Savin Hood API provides UK tax calculation and optimisation services. Calculate income tax, National Insurance contributions, child benefit charges, and discover tax-saving strategies for both PAYE employees and limited company contractors.
Authentication
- Public endpoints: No authentication required (calculators)
- Protected endpoints: Session-based authentication (tracker, profiles)
- GPT Actions endpoints: API key header (`x-api-key`)
Rate Limits
- Anonymous: 100 requests per hour
- Authenticated: 1,000 requests per hour
Main Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /v1/calculator/ | POST | Calculate household taxes, benefits, and optimisation strategies |
| /v1/calculator/contractor/ | POST | Calculate contractor taxes and dividend strategies |
| /v1/tracker/ | GET | Get real-time tax position from tracked income (authenticated) |
| /openapi.json | GET | OpenAPI 3.0 schema specification |
| /openapi-gpt.json | GET | Scoped OpenAPI schema for ChatGPT Custom GPT Actions |
OpenAPI Specification
Download the full API schema for use with Postman, code generators, or other tools.
https://api.savinhood.com/openapi.jsonhttps://api.savinhood.com/openapi-gpt.json
Interactive Reference
Explore the complete API documentation, including request/response schemas and example payloads.
Open Interactive Reference