Get appointment statistics

Reads Admin > Statistiques RDV for a period: bookings, online share, new clients, no-shows, per service and per staff member.

GET https://cotlet.dev/api/v1/planity/appointment-stats

read

Returns the figures of the tabs Indicateurs clés, Prestations, Collaborateurs, RDV and RDV pas venus. All figures come from the appointments recorded in the agenda. estimated_revenue is Planity's estimate from bookings, not takings from the cash register.

Parameters

Parameters: get_appointment_stats
NameTypeDescription
date_from string required string First day, YYYY-MM-DD.
date_to string required string Last day, YYYY-MM-DD, included.
compare_previous boolean boolean Also return the previous period of the same length, as the compare option does. Default false.

Request

cURL
curl "https://cotlet.dev/api/v1/planity/appointment-stats?date_from=2026-10-12&date_to=2026-10-18&compare_previous=true" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("planity", "get_appointment_stats", {"date_from":"2026-10-12","date_to":"2026-10-18","compare_previous":True})
Node.js
const result = await cotlet.call('planity', 'get_appointment_stats', {"date_from":"2026-10-12","date_to":"2026-10-18","compare_previous":true});
CLI
cotlet call planity get_appointment_stats --data '{"date_from":"2026-10-12","date_to":"2026-10-18","compare_previous":true}'

Example response

JSON

{
  "date_from": "2026-10-12",
  "date_to": "2026-10-18",
  "appointments": 154,
  "online": 96,
  "in_salon": 58,
  "online_rate_percent": 62.3,
  "new_clients": 21,
  "no_shows": 3,
  "estimated_revenue": 6120,
  "by_service": [
    {
      "service": "Coupe homme",
      "appointments": 55
    },
    {
      "service": "Coupe femme",
      "appointments": 41
    },
    {
      "service": "Brushing",
      "appointments": 35
    },
    {
      "service": "Couleur",
      "appointments": 23
    }
  ],
  "by_staff": [
    {
      "staff": "Amélie",
      "appointments": 62
    },
    {
      "staff": "Lucas",
      "appointments": 51
    },
    {
      "staff": "Inès",
      "appointments": 41
    }
  ],
  "previous": {
    "date_from": "2026-10-05",
    "date_to": "2026-10-11",
    "appointments": 141,
    "online": 83,
    "in_salon": 58
  }
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.