{
  "info": {
    "_postman_id": "14ac22e0-4ab7-48fb-8c6b-2fb7ce71d4ab",
    "name": "Apex Odonto Dental EHR API",
    "description": "**Apex Odonto\u2122** is Parker Apex's FHIR-first Dental EHR product line. Partners integrate via\nthe shared gateway at `api.parkerapex.com/fhir/R4` with GPID-scoped OAuth and required headers.\n\nClinical workflows include odontogram/tooth charting, periodontal charting, treatment plans,\ndental procedures, imaging attachments, lab/appliance orders, eligibility, and dental claim\ntype (`oral`).\n\nTooth and surface details use Parker extensions where standard FHIR is insufficient:\n- `https://schemas.parkerapex.com/fhir/StructureDefinition/tooth-number`\n- `https://schemas.parkerapex.com/fhir/StructureDefinition/tooth-surface`\n\n**Golden bundle:** `docs/schemas/specialty/odonto-golden-bundle.r4.json`\n**Product code:** `odonto` \u00b7 **Claim type:** `oral`\n\nRequired partner headers on every write:\n- `X-Apex-Actor-GPID` \u2014 organizational actor GPID\n- `X-Apex-Subject-GPID` \u2014 patient GPID\n- `X-Apex-Source` \u2014 integration source identifier\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{access_token}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.parkerapex.com/fhir/R4",
      "type": "string"
    },
    {
      "key": "access_token",
      "value": "REPLACE_WITH_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Conformance",
      "item": [
        {
          "name": "FHIR CapabilityStatement (dental resource set)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/metadata",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "metadata"
              ]
            },
            "description": ""
          }
        }
      ]
    },
    {
      "name": "Identity",
      "item": [
        {
          "name": "Search dental patients by GPID or demographics",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Patient",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Patient"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Create patient (IdentityResolver required)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Patient",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Patient"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Scheduling",
      "item": [
        {
          "name": "Search chair appointments and hygiene recall",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Appointment",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Appointment"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Book dental appointment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Appointment",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Appointment"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Clinical",
      "item": [
        {
          "name": "Open dental visit encounter",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Encounter",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Encounter"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Search completed dental procedures (CDT-coded)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Procedure",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Procedure"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Post completed dental procedure",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Procedure",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Procedure"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Search treatment plans",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/CarePlan",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "CarePlan"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Create dental treatment plan",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/CarePlan",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "CarePlan"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Charting",
      "item": [
        {
          "name": "Search odontogram and periodontal chart observations",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Observation",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Observation"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Record tooth chart or periodontal finding",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Observation",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Observation"
              ]
            },
            "description": "Use tooth-number and tooth-surface extensions on Observation for odontogram entries.\n",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Imaging",
      "item": [
        {
          "name": "Attach bitewing, panoramic, CBCT, or intraoral image",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/DocumentReference",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "DocumentReference"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Submit radiology narrative or grouped imaging report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/DiagnosticReport",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "DiagnosticReport"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Lab",
      "item": [
        {
          "name": "Order lab work (crown, bridge, aligner, denture)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/ServiceRequest",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "ServiceRequest"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Order dental appliance (night guard, retainer, aligner)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/DeviceRequest",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "DeviceRequest"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Financial",
      "item": [
        {
          "name": "Dental benefits check (preventive, restorative, perio, ortho)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/CoverageEligibilityRequest",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "CoverageEligibilityRequest"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Submit dental claim or preauthorization (Claim.type = oral)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/Claim",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "Claim"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Read payer adjudication for dental claim",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/ClaimResponse",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "ClaimResponse"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Search dental EOBs for patient",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/ExplanationOfBenefit",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "ExplanationOfBenefit"
              ]
            },
            "description": ""
          }
        }
      ]
    },
    {
      "name": "Operational",
      "item": [
        {
          "name": "Get odontogram and periodontal chart for patient",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/odonto/v1/chart/{patientGpid}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "odonto",
                "v1",
                "chart",
                "{patientGpid}"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Update tooth/surface findings (maps to FHIR Observations)",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/odonto/v1/chart/{patientGpid}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "odonto",
                "v1",
                "chart",
                "{patientGpid}"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Create dental treatment plan (CarePlan + Tasks)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/odonto/v1/treatment-plans",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "odonto",
                "v1",
                "treatment-plans"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Post completed CDT-coded procedure to chart and claim queue",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/odonto/v1/procedures/post",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "odonto",
                "v1",
                "procedures",
                "post"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Order crown, bridge, aligner, or denture from external lab",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/odonto/v1/lab/orders",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "odonto",
                "v1",
                "lab",
                "orders"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Upload bitewing, panoramic, CBCT, or intraoral image",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/odonto/v1/imaging/upload",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "odonto",
                "v1",
                "imaging",
                "upload"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    }
  ]
}