Get fee schedule by ID

Request

Returns the single fee schedule matching id for the practice identified by X-Practice-Id. Dentally's user interface in the United Kingdom sometimes calls this a payment plan. The identifier is the same id returned when listing fee schedules.

If no fee schedule exists for that practice and id, the API responds with 404.

Security

oauth2(Required scopes: fee_schedule:read)

Path

idstring, (uuid)required

Resource identifier to filter/find.

X-Practice-Idstring, (uuid)required

UUID of the practice in whose context the request is executed. The API uses this to resolve data the caller is permitted to access for that practice.

curl -i -X GET \
  'https://docs.api.dentally.com/_mock/docs/versions/2026-01-01/nexgen/fee_schedules/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Practice-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08'

Responses

Full details for one fee schedule.

Bodyapplication/json

dataobject(fee-schedule)required

A fee schedule is a practice-defined pricing and care category (for example Private, NHS, or a membership plan), not an instalment schedule. Dentally's user interface in the United Kingdom sometimes calls this a payment plan. Each patient is assigned one fee schedule. The schedule determines default booking lengths, suggested recall and communication values for new patients, how fees are funded, and optional membership pricing.

Treatment prices live on a separate fee list and are not included here.

Response

A fee schedule configured for the practice.

{
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "OHSA - MoH",
    "patient_friendly_name": "Oral Health Services Adolescents (OHSA)",
    "is_active": true,
    "site_id": null,
    "account_code": "200",
    "funding": { … },
    "default_appointment_duration": { … },
    "patient_default": { … },
    "membership": { … },
    "created_at": "2024-04-01T00:00:00Z",
    "updated_at": "2026-01-20T08:45:00Z"
  }
}