Torli API

Confirms that a key works and reports which business it belongs to and what it is allowed to do. Make this your first call when setting up an integration.

Example request

Copycurl https://torli.net/torliapi/v1/me \
  -H "Authorization: Bearer torli_sk_YOUR_KEY"

Example response

Copy{
  "business": {
    "id": "64f92377b0db42b258177408",
    "name": "Dana's Barbershop"
  },
  "scopes": [
    { "scope": "services:read",     "description": "List the services the business offers" },
    { "scope": "workers:read",      "description": "List the workers of the business" },
    { "scope": "availability:read", "description": "Read free appointment slots" },
    { "scope": "appointments:write","description": "Book appointments on behalf of customers" }
  ]
}

Lists the services the business offers. Use the returned id as service_id in the availability and booking calls. Services hidden in the dashboard are not returned.

Example request

Copycurl https://torli.net/torliapi/v1/services \
  -H "Authorization: Bearer torli_sk_YOUR_KEY"

Example response

Copy{
  "services": [
    {
      "id": "656e49108ab3575e936ba0e1",
      "name": "Haircut",
      "description": "A classic haircut",
      "duration": 60,
      "price": 80
    },
    {
      "id": "656e49108ab3575e936ba0e2",
      "name": "Beard trim",
      "description": "",
      "duration": 20,
      "price": 40
    }
  ]
}

Lists the workers of the business. Each worker carries the ids of the services they perform, so you can offer the customer only the workers who can do the chosen service.

Example request

Copycurl https://torli.net/torliapi/v1/workers \
  -H "Authorization: Bearer torli_sk_YOUR_KEY"

Example response

Copy{
  "workers": [
    {
      "id": "64f923d5b0db42b258177415",
      "name": "Dana",
      "service_ids": ["656e49108ab3575e936ba0e1"]
    }
  ]
}

Returns the times at which the given service can start with the given worker on one day. Each value is a start time in HH:mm; the appointment runs for the duration of the service.

Parameters

Example request

Copycurl -G https://torli.net/torliapi/v1/availability \
  -H "Authorization: Bearer torli_sk_YOUR_KEY" \
  -d service_id=656e49108ab3575e936ba0e1 \
  -d worker_id=64f923d5b0db42b258177415 \
  -d date=2026-10-06 \
  -d splitTime=30

Example response

Copy{
  "date": "2026-10-06",
  "worker_id": "64f923d5b0db42b258177415",
  "service_id": "656e49108ab3575e936ba0e1",
  "duration": 60,
  "available_times": ["10:00", "10:30", "11:00", "13:00", "13:30"]
}

Books an appointment. If the phone number does not belong to an existing customer, a customer record is created automatically. The customer receives the same WhatsApp confirmation as a booking made in the dashboard.

Parameters

Example request

Copycurl -X POST https://torli.net/torliapi/v1/appointments \
  -H "Authorization: Bearer torli_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "656e49108ab3575e936ba0e1",
    "worker_id": "64f923d5b0db42b258177415",
    "appointment_time": "2026-10-06T10:30",
    "customerPhone": "0501234567",
    "customerName": "Yossi Levi"
  }'

Example response

Copy{
  "id": "64f923d5b0db42b258177004",
  "appointment_time": "2026-10-06T10:30",
  "duration": 60,
  "status": "approved",
  "customer_notified": true,
  "service": { "id": "656e49108ab3575e936ba0e1", "name": "Haircut", "price": 80 },
  "worker":  { "id": "64f923d5b0db42b258177415", "name": "Dana" },
  "customer":{ "id": "64f923d5b0db42b258177003", "name": "Yossi Levi", "phone": "0501234567" }
}