The UzmiTermin API sends your company's appointments to your server as JSON: date and time, status, master, services, client's name and phone. Use it to show upcoming visits in a personal account on your website, export appointments to a spreadsheet or pass them to a CRM. The API is read-only. In this guide you will create a key, send your first request and go through the response.
Sign in to your company account and open the API keys section on this page.
Create a key and give it a clear name, for example "Website".
Copy the key right away and save it in your server settings - for example, in the UZMI_API_KEY environment variable. The key is shown only once: we store only its fingerprint, so a lost key cannot be recovered, only replaced with a new one.
If a key may have fallen into the wrong hands, revoke it: it stops working immediately.
Get an API keyPass the key in the Authorization header and request the appointments for a week:
curl "https://public-api.uzmitermin.rs/v1/appointments?from=2026-10-19&to=2026-10-25" \
-H "Authorization: Bearer $UZMI_API_KEY"
The response is an array of appointments sorted by date and start time:
[
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"date": "2026-10-23",
"startTime": "10:00",
"endTime": "11:00",
"status": "CONFIRMED",
"master": { "id": "1b4e28ba-2fa1-41d2-883f-0016d3cca427", "name": "Irina" },
"services": [{ "id": "6fa459ea-ee8a-4ca4-894e-db77e160355e", "name": "Haircut", "duration": 60 }],
"client": { "name": "Ana", "phone": "+381601234567" },
"comment": null,
"createdAt": "2026-10-20T12:00:00.000Z",
"updatedAt": "2026-10-21T09:30:00.000Z"
}
]
The period is set with the from and to parameters - dates in YYYY-MM-DD format, both inclusive, no longer than 31 days. All appointments come at once, without pagination.
| Parameter | Required | What it sets |
|---|---|---|
from | Yes | The first day of the period |
to | Yes | The last day of the period, no more than 31 days after from |
masterId | No | Only one master's appointments |
status | No | Only appointments with these statuses, comma-separated: CONFIRMED,MASTER_CONFIRMATION |
The same request from your website's code:
PHP
<?php
$url = 'https://public-api.uzmitermin.rs/v1/appointments?' . http_build_query([
'from' => '2026-10-19',
'to' => '2026-10-25',
'status' => 'CONFIRMED',
]);
$response = file_get_contents($url, false, stream_context_create([
'http' => ['header' => 'Authorization: Bearer ' . getenv('UZMI_API_KEY')],
]));
$appointments = json_decode($response, true);
Node.js
const params = new URLSearchParams({ from: '2026-10-19', to: '2026-10-25', status: 'CONFIRMED' });
const response = await fetch(`https://public-api.uzmitermin.rs/v1/appointments?${params}`, {
headers: { Authorization: `Bearer ${process.env.UZMI_API_KEY}` },
});
const appointments = await response.json();
A single appointment can be fetched by its ID: GET /v1/appointments/{id}.
| Field | What it contains |
|---|---|
date, startTime, endTime | Date and time of the visit in the salon's time zone |
status | Appointment status, see below |
master | Master: id and name. null if no master is selected |
services | Services: id, name and duration in minutes |
client | Client: name and phone |
comment | Appointment comment or null |
createdAt, updatedAt | When the appointment was created and last changed |
| Status | Meaning |
|---|---|
ACTIVE | Booked |
MASTER_CONFIRMATION | Waiting for the master's confirmation |
USER_CONFIRMATION | Waiting for the client to confirm the new time |
CONFIRMED | Confirmed |
REJECTED | The master declined, or the client said the appointment is not theirs |
CANCELED | Canceled |
To find what has changed since the previous export, compare the appointment's updatedAt with the time of that export.
Each key gets 60 requests per minute. The response headers X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset show how many are left.
| Code | When |
|---|---|
400 | Invalid dates, to before from, a period longer than 31 days or an unknown status |
401 | No key, or the key is wrong or revoked |
403 | The company has no active subscription |
404 | There is no such appointment in your company |
429 | Too many requests |