Basics
The common rules of the KiTbetter Partner API.
Base URL
| Item | Value | Notes |
|---|---|---|
| Base URL | https://api.kitbetter.com/partner/v1 |
Any change is announced in advance |
| Protocol | HTTPS only | HTTP requests are rejected |
| Version | URL path version (/v1) |
Backward-incompatible changes will ship as a new version |
Request & response format
- Request and response bodies are always JSON (UTF-8).
- Include a
Content-Type: application/jsonheader on requests that have a body. - Responses are returned with
Content-Type: application/json; charset=utf-8. - Dates and times use ISO 8601 (
2026-08-04T15:00:00+09:00).
POST /partner/v1/... HTTP/1.1
Host: api.kitbetter.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: application/json
Authentication headers
Send your API key in the X-API-Key header on every request.
| Header | Value | Required |
|---|---|---|
X-API-Key |
Your issued API key | Required |
Content-Type |
application/json |
Only for requests with a body |
Accept |
application/json |
Recommended |
A missing or invalid key returns 401, and accessing a resource you are not authorized for returns 403. For details, see Authenticate requests.
Errors & rate limits
- Error response body format and how to handle each status code: Error codes
- Call allowances and handling
429: Rate limits