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.

Before you begin

Create a key

  1. Sign in to your company account and open the API keys section on this page.

  2. Create a key and give it a clear name, for example "Website".

  3. 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 key

Send your first request

Pass 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"
  }
]

Get appointments for a period

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.

ParameterRequiredWhat it sets
fromYesThe first day of the period
toYesThe last day of the period, no more than 31 days after from
masterIdNoOnly one master's appointments
statusNoOnly 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}.

Read the response

FieldWhat it contains
date, startTime, endTimeDate and time of the visit in the salon's time zone
statusAppointment status, see below
masterMaster: id and name. null if no master is selected
servicesServices: id, name and duration in minutes
clientClient: name and phone
commentAppointment comment or null
createdAt, updatedAtWhen the appointment was created and last changed
StatusMeaning
ACTIVEBooked
MASTER_CONFIRMATIONWaiting for the master's confirmation
USER_CONFIRMATIONWaiting for the client to confirm the new time
CONFIRMEDConfirmed
REJECTEDThe master declined, or the client said the appointment is not theirs
CANCELEDCanceled

To find what has changed since the previous export, compare the appointment's updatedAt with the time of that export.

Handle errors and limits

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.

CodeWhen
400Invalid dates, to before from, a period longer than 31 days or an unknown status
401No key, or the key is wrong or revoked
403The company has no active subscription
404There is no such appointment in your company
429Too many requests

What's next