Get appointment

Reads one appointment with its notes, extra services and the client's contact details.

GET https://cotlet.dev/api/v1/planity/appointments/{appointment_id}

read

Returns the fields the appointment window shows: client, date and start time, service, staff member, extra services, notes and title. It does not return payment tickets; the cash register is not covered.

Parameters

Parameters: get_appointment
NameTypeDescription
appointment_id string required string Id from list_appointments.

Request

cURL
curl https://cotlet.dev/api/v1/planity/appointments/appointment_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("planity", "get_appointment", {"appointment_id":"appointment_8c41d2"})
Node.js
const result = await cotlet.call('planity', 'get_appointment', {"appointment_id":"appointment_8c41d2"});
CLI
cotlet call planity get_appointment --data '{"appointment_id":"appointment_8c41d2"}'

Example response

JSON

{
  "appointment_id": "a_9120",
  "start": "2026-10-26T09:30:00",
  "end": "2026-10-26T10:30:00",
  "client": {
    "client_id": "c_1042",
    "name": "Léa Martin",
    "phone": "+33 6 00 00 00 00"
  },
  "service": "Coupe femme",
  "extra_services": [],
  "staff": {
    "staff_id": "st_01",
    "name": "Amélie"
  },
  "status": "confirmed",
  "notes": "Wants to keep the length."
}

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.