Treatments

Treatments are the procedures performed or recorded for a patient, with the treatment definition, provider, appointment, and plan embedded. All endpoints require the treatments:read scope.

#The treatment object

Field	Type	Description
`id`	string	Unique treatment record id.
`patient`	object \| null	Embedded patient summary.
`treatment`	object \| null	The treatment definition (`id`, `name`, `code`).
`provider`	object \| null	Provider who performed it (`id`, `name`).
`appointment`	object \| null	Linked appointment (`id`, `start`, `end`).
`plan`	object \| null	Treatment plan it belongs to (`id`, `name`).
`quantity`	integer	Number of units.
`price`	number \| null	Recorded price.
`performed_at`	string \| null	ISO 8601 time performed.
`created_at`	string \| null	ISO 8601 timestamp.
`updated_at`	string \| null	ISO 8601 timestamp.

#List a patient's treatments

GET

Returns a paginated list of treatments for the patient.

Parameter	In	Description
`id`	path	The patient id.
`appointment_id`	query	Only treatments for one appointment.
`limit`, `cursor`	query	Pagination.

curl https://api.smile-app.co.il/v1/patients/8842/treatments \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "9001",
      "patient": { "id": "8842", "first_name": "Dana", "last_name": "Levi" },
      "treatment": { "id": "44", "name": "Composite filling", "code": "D2391" },
      "provider": { "id": "12", "name": "Dr. Cohen" },
      "appointment": { "id": "55021", "start": "2026-07-01T09:00:00+03:00", "end": "2026-07-01T09:30:00+03:00" },
      "plan": { "id": "70", "name": "Restorative 2026" },
      "quantity": 1,
      "price": 480.0,
      "performed_at": "2026-07-01T09:20:00+03:00"
    }
  ],
  "next_cursor": null
}

#Retrieve a treatment

GET

curl https://api.smile-app.co.il/v1/treatments/9001 \
  -H "Authorization: Bearer sk_live_..."

#Catalog vs. recorded treatments

Two related things named "treatment"

The catalog treatment (/v1/catalog/treatments) is the menu of procedures a clinic offers - name, code, default price. A recorded treatment (here) is one actually performed for a patient, referencing a catalog treatment via its embedded treatment object.