Perio Exams (Periodontal Charts)

Create, view, update, and delete periodontal exams. Per OpenDental API.

Patient Number (PatNum)

ExamDate (optional)

Submit

Loading perio exams...

PerioExamNum	PatNum	ExamDate	ProvNum	DateTMeasureEdit	Note	Actions

Enter a patient number and click "Load Perio Exams" to view.

Create Perio Exam

Required

PatNum *

Exam Details

ExamDate (yyyy-MM-dd)

Optional. Default: today

ProvNum

Optional. Default: patient's primary provider

Note

Perio Measures (creates PerioMeasures when provided)

Strings parsed left-to-right. Integers 0-9 = probing; b,s,p,c = bleeding, suppuration, plaque, calculus. Regions: UpperFacial (teeth 1-16), UpperLingual, LowerLingual, LowerFacial (teeth 17-32). See API docs.

UpperFacial

UpperLingual

LowerLingual

LowerFacial

Result:

Search & Update Perio Exam

Patient Number (PatNum)

Or PerioExamNum

Select a perio exam to update or delete:

Update Perio Exam

Perio Exam: —

ExamDate (yyyy-MM-dd)

ProvNum

Note

Overwrites existing note

Result:

PerioExams - GET Response

GET /perioexams?PatNum=236 or GET /perioexams?ExamDate=2023-04-01. Per OpenDental API.

Example Response:

[
  {
    "PerioExamNum": 171,
    "PatNum": 236,
    "ExamDate": "2023-04-01",
    "ProvNum": 2,
    "DateTMeasureEdit": "2023-04-01 05:25:46",
    "Note": ""
  }
]

All Fields:

PerioExamNum: Unique perio exam ID (read-only)
PatNum: Patient number
ExamDate: Date of exam, yyyy-MM-dd
ProvNum: Provider number
DateTMeasureEdit: Last measure edit timestamp (read-only)
Note: Note for the exam

Create Perio Exam - JSON Structure

POST /perioexams. Required: PatNum. Per OpenDental API.

Example Request (minimal):

{
  "PatNum": 20
}

Example Request (with measures):

{
  "PatNum": 20,
  "UpperFacial": "32b4b32432332332332bs132332331342c3c3253233223p2c3p22b3b343",
  "UpperLingual": "323,323,322,222,232,222,212,212,212,212,232,323,323,323,343,343",
  "LowerLingual": "3b2b4b 424 323 323 323 321 323 323.313 42c3c 325 323 322 3p2c3p 22b3b 343c",
  "LowerFacial": "4 3b 2s 4bs 4p 2bp 4sp 3bsp 2c 3bc 3sc 2bsc 3pc 3bpc 2spc 3bspc",
  "ExamDate": "2023-05-12",
  "ProvNum": 3,
  "Note": ""
}

Example Response (201 Created):

{
  "PerioExamNum": 31,
  "PatNum": 20,
  "ExamDate": "2023-05-12",
  "ProvNum": 3,
  "DateTMeasureEdit": "2023-05-12 13:21:48",
  "Note": ""
}

Create Fields:

PatNum: Required. FK to patient
UpperFacial, UpperLingual, LowerLingual, LowerFacial: Optional. Probing/bleeding strings. b,s,p,c = bleeding, suppuration, plaque, calculus
ExamDate: Optional. yyyy-MM-dd. Default: today
ProvNum: Optional. Default: patient's primary provider
Note: Optional

Update & Delete Perio Exam

PUT /perioexams/{PerioExamNum} and DELETE /perioexams/{PerioExamNum}. Per OpenDental API.

PUT Request (all optional):

{
  "ExamDate": "2023-06-15",
  "ProvNum": 2,
  "Note": "Overall improvement!"
}

Updatable: ExamDate, ProvNum, Note. Note overwrites existing.

DELETE /perioexams/{PerioExamNum}

Returns 200 OK. Deletes exam and all associated PerioMeasures.