Get time ranges

GET

{{server}}/api/v1/appointment/ranges?branch={{branch}}&start=1745842416996&end=1746050399999&service=00000000-0000-4000-0007-000000000001

This endpoint retrieves the available appointment ranges based on the specified branch, start and end times, and service.

Request

branch (string, required): Branch key
start (integer, required): The start time for the appointment range.
end (integer, required): The end time for the appointment range.
service (string, required): Service key.
clerk (string, optional): Clerk key in case of clerk selection

Response

The response contains an array of appointment time slots.

service (string): Service key
start (number): Slot start time
end (number): Slot end time
available (number): Number of available slot.

Request

Authorization

Header	Value
`Authorization`	`SmartToken {{smartToken}}`

Headers

Key	Value
`Accept`	`application/json`

Query parameters

Key	Value
`branch`	`{{branch}}`
`start`	`1745842416996`
`end`	`1746050399999`
`service`	`00000000-0000-4000-0007-000000000001`

Code snippets

cURL
JavaScript
Python

curl -X GET '{{server}}/api/v1/appointment/ranges?branch={{branch}}&start=1745842416996&end=1746050399999&service=00000000-0000-4000-0007-000000000001' \
  -H 'Accept: application/json' \
  -H 'Authorization: SmartToken {{smartToken}}'

const response = await fetch("{{server}}/api/v1/appointment/ranges?branch={{branch}}&start=1745842416996&end=1746050399999&service=00000000-0000-4000-0007-000000000001", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "SmartToken {{smartToken}}"
  },
});

const data = await response.json();
console.log(data);

import requests

url = "{{server}}/api/v1/appointment/ranges?branch={{branch}}&start=1745842416996&end=1746050399999&service=00000000-0000-4000-0007-000000000001"
headers = {
    "Accept": "application/json",
    "Authorization": "SmartToken {{smartToken}}"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())

Example

Example request

GET

{{server}}/api/v1/appointment/ranges?branch={{branch}}&start=1745842416996&end=1746050399999&service=00000000-0000-4000-0007-000000000001

Query parameters (4)

Key	Value
`branch`	`{{branch}}`
`start`	`1745842416996`
`end`	`1746050399999`
`service`	`00000000-0000-4000-0007-000000000001`

Headers (1)

Key	Value
`Accept`	`application/json`

Example response 200 Ok

Response headers (9)

Key	Value
`Access-Control-Expose-Headers`	`*`
`Cache-Control`	`no-store, no-cache, must-revalidate`
`Access-Control-Allow-Origin`	`*`
`Access-Control-Allow-Methods`	`POST, PUT, GET, OPTIONS, DELETE`
`Access-Control-Allow-Credentials`	`true`
`Content-Length`	`8940`
`Access-Control-Max-Age`	`86400`
`Access-Control-Allow-Headers`	`Content-Type, Authorization, X-Requested-With`
`Content-Type`	`application/json;charset=utf-8`

Body
{
  "times": [
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745842500000,
      "end": 1745843400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745843400000,
      "end": 1745844300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745844300000,
      "end": 1745845200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745845200000,
      "end": 1745846100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745846100000,
      "end": 1745847000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745847000000,
      "end": 1745847900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745847900000,
      "end": 1745848800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745848800000,
      "end": 1745849700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745849700000,
      "end": 1745850600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745850600000,
      "end": 1745851500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745851500000,
      "end": 1745852400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745906400000,
      "end": 1745907300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745907300000,
      "end": 1745908200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745908200000,
      "end": 1745909100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745909100000,
      "end": 1745910000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745910000000,
      "end": 1745910900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745910900000,
      "end": 1745911800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745911800000,
      "end": 1745912700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745912700000,
      "end": 1745913600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745913600000,
      "end": 1745914500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745914500000,
      "end": 1745915400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745915400000,
      "end": 1745916300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745916300000,
      "end": 1745917200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745917200000,
      "end": 1745918100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745918100000,
      "end": 1745919000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745919000000,
      "end": 1745919900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745919900000,
      "end": 1745920800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745920800000,
      "end": 1745921700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745921700000,
      "end": 1745922600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745922600000,
      "end": 1745923500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745923500000,
      "end": 1745924400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745924400000,
      "end": 1745925300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745925300000,
      "end": 1745926200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745926200000,
      "end": 1745927100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745927100000,
      "end": 1745928000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745928000000,
      "end": 1745928900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745928900000,
      "end": 1745929800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745929800000,
      "end": 1745930700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745930700000,
      "end": 1745931600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745931600000,
      "end": 1745932500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745932500000,
      "end": 1745933400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745933400000,
      "end": 1745934300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745934300000,
      "end": 1745935200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745935200000,
      "end": 1745936100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745936100000,
      "end": 1745937000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745937000000,
      "end": 1745937900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745937900000,
      "end": 1745938800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745992800000,
      "end": 1745993700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745993700000,
      "end": 1745994600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745994600000,
      "end": 1745995500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745995500000,
      "end": 1745996400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745996400000,
      "end": 1745997300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745997300000,
      "end": 1745998200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745998200000,
      "end": 1745999100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1745999100000,
      "end": 1746000000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746000000000,
      "end": 1746000900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746000900000,
      "end": 1746001800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746001800000,
      "end": 1746002700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746002700000,
      "end": 1746003600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746003600000,
      "end": 1746004500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746004500000,
      "end": 1746005400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746005400000,
      "end": 1746006300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746006300000,
      "end": 1746007200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746007200000,
      "end": 1746008100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746008100000,
      "end": 1746009000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746009000000,
      "end": 1746009900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746009900000,
      "end": 1746010800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746010800000,
      "end": 1746011700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746011700000,
      "end": 1746012600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746012600000,
      "end": 1746013500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746013500000,
      "end": 1746014400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746014400000,
      "end": 1746015300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746015300000,
      "end": 1746016200000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746016200000,
      "end": 1746017100000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746017100000,
      "end": 1746018000000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746018000000,
      "end": 1746018900000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746018900000,
      "end": 1746019800000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746019800000,
      "end": 1746020700000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746020700000,
      "end": 1746021600000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746021600000,
      "end": 1746022500000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746022500000,
      "end": 1746023400000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746023400000,
      "end": 1746024300000,
      "available": 1
    },
    {
      "service": "00000000-0000-4000-0007-000000000001",
      "start": 1746024300000,
      "end": 1746025200000,
      "available": 1
    }
  ],
  "timeout": 21600000,
  "timeZone": "Europe/Budapest"
}

Request

Response

Request​

Authorization​

Headers​

Query parameters​

Code snippets​

Example​

Request

Authorization

Headers

Query parameters

Code snippets

Example