Conventions
A few rules hold across the whole API. Learn them once.
Base URL
| Region | Base URL |
|---|---|
| Default | https://api.sance.ai |
| Russia | https://api.ru.sance.ai |
All endpoints live under /v1 — e.g. https://api.sance.ai/v1/leads. Use the host that
matches your region; the paths are identical.
Product scoping
Most endpoints operate within a product (your workspace) and require a product_id
(as a query parameter or in the body). The API verifies that your account can access that
product; if not, you get 403/404. List your products to find the id:
curl -s https://api.sance.ai/v1/products/ -H "Authorization: Bearer $TOKEN"
Pagination
List endpoints accept page (default 1) and limit, and return a paginated envelope:
{ "items": [ ... ], "page": 1, "limit": 50, "total": 220, "pages": 5 }
Errors
Errors use standard HTTP status codes with a JSON { "detail": "..." } body:
| Code | Meaning |
|---|---|
400 | Bad request (invalid input or combination) |
401 / 403 | Missing/invalid token, or no access to the resource |
404 | Not found |
409 | Conflict (e.g. duplicate) |
422 | Validation error |
Timestamps
All timestamps are UTC, ISO 8601 (e.g. 2026-06-08T10:00:00Z).