# Boxento public API

JSON APIs on https://boxento.com for agents and scripts. No API key. Country codes are ISO 3166-1 alpha-2.

Nationwide public holidays and statutory floors only. Not legal advice. Boxento does not calculate payroll.

## Endpoints

| Method | Path | What it returns |
| --- | --- | --- |
| GET | `/health` | `{ "status": "ok" }` |
| GET | `/api/v1/holidays/{country}/{year}.json` | Nationwide public holidays for that year |
| GET | `/api/v1/working-day?country=CL&date=2026-09-18` | `working`, `weekend`, or `public_holiday` |
| GET | `/api/v1/working-days?country=CL&from=2026-09-01&to=2026-09-30` | Working-day count in an inclusive range |
| GET | `/api/v1/labor/{country}.json` | Sourced statutory floors (leave, hours, 13th month), or 404 if unpublished |
| GET | `/api/v1/pricing/{country}.json` | Per-employee monthly Boxento price |
| GET | `/openapi.json` | OpenAPI 3.1 |
| POST | `/mcp` | MCP Streamable HTTP (same data as tools) |

Holiday years are the current calendar year and the next one, matching the public holiday pages. Holiday names come from [date-holidays](https://github.com/commenthol/date-holidays) (CC BY 3.0).

Workspace sign-up and tenant HR APIs live on https://auth.boxento.com and `{slug}.boxento.com`. They are not these endpoints. See https://boxento.com/auth.md.

## Content negotiation

HTML pages also answer `Accept: text/markdown` with a markdown body (`Content-Type: text/markdown`). The product summary is always at `/llms.txt`.