Definitions & Settings
57 endpoints
Codes
12 endpoints
/api/v1/{org_id}/codes/explosion-codesList Explosion Codes
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
searchstringstatusstringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/codes/explosion-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/codes/explosion-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}Get Explosion Code
Parameters
Path Parameters
explosion_code_uuidstringrequiredorg_idstringrequiredResponses
conditionsobject[]created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringentriesobject[]idstring (uuid)requirednamestringrequiredstatusstringrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/icd-codesList Icd Codes
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
searchstringcategorystringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/codes/icd-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/codes/icd-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/icd-codes/{icd_code_uuid}Get Icd Code
Parameters
Path Parameters
icd_code_uuidstringrequiredorg_idstringrequiredResponses
categorystringrequiredcodestringrequiredcreated_atstring (date-time)requireddescriptionstringrequiredidstring (uuid)requiredupdated_atstring (date-time)requireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/codes/icd-codes/{icd_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/codes/icd-codes/{icd_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/procedure-codesList procedure codes
List procedure codes (CDT/ADA + practice-custom) with optional filters. Staff callers receive the full ``ProcedureCodeListOut`` shape.
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
statusstringsearchstringcategorystringcode_typestringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/codes/procedure-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/codes/procedure-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}Get procedure code
Retrieve a single procedure code by UUID. Staff callers receive the full ``ProcedureCodeOut`` shape.
Parameters
Path Parameters
procedure_code_uuidstringrequiredorg_idstringrequiredResponses
apply_sales_taxbooleanrequiredcategorystringrequiredcodestringrequiredcode_in_claimsstringcode_typestringrequiredcreated_atstring (date-time)requireddefault_billing_orderstringrequireddefault_feestringrequireddeleted_atstring (date-time)descriptionstringrequiredeffective_datestring (date)icd_code_mandatorybooleanrequiredidstring (uuid)requiredis_orthobooleanrequiredlabelstringprovider_mandatorybooleanrequiredprovider_typestringservice_typestringrequiredshort_namestringrequiredsmart_code_logicbooleanrequiredstatusstringrequiredtermination_datestring (date)under_eighteen_onlybooleanrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/explosion-codesCreate Explosion Code
Parameters
Path Parameters
org_idstringrequiredRequest Body
conditionsobject[]descriptionstringentriesobject[]namestringrequiredResponses
conditionsobject[]created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringentriesobject[]idstring (uuid)requirednamestringrequiredstatusstringrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/codes/explosion-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"conditions": null,
"description": "string",
"entries": null,
"name": "string"
}'curl -X POST "https://api.example.com/api/v1/{org_id}/codes/explosion-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"conditions": null,
"description": "string",
"entries": null,
"name": "string"
}'/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}/archiveArchive Explosion Code
Parameters
Path Parameters
explosion_code_uuidstringrequiredorg_idstringrequiredResponses
conditionsobject[]created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringentriesobject[]idstring (uuid)requirednamestringrequiredstatusstringrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/procedure-codesCreate Procedure Code
Parameters
Path Parameters
org_idstringrequiredRequest Body
apply_sales_taxbooleancategorystringcodestringrequiredcode_in_claimsstringcode_typestringdefault_billing_orderstringdefault_feenumberdescriptionstringeffective_datestring (date)icd_code_mandatorybooleanis_orthobooleanlabelstringprovider_mandatorybooleanprovider_typestringservice_typestringshort_namestringrequiredsmart_code_logicbooleanstatusstringtermination_datestring (date)under_eighteen_onlybooleanResponses
apply_sales_taxbooleanrequiredcategorystringrequiredcodestringrequiredcode_in_claimsstringcode_typestringrequiredcreated_atstring (date-time)requireddefault_billing_orderstringrequireddefault_feestringrequireddeleted_atstring (date-time)descriptionstringrequiredeffective_datestring (date)icd_code_mandatorybooleanrequiredidstring (uuid)requiredis_orthobooleanrequiredlabelstringprovider_mandatorybooleanrequiredprovider_typestringservice_typestringrequiredshort_namestringrequiredsmart_code_logicbooleanrequiredstatusstringrequiredtermination_datestring (date)under_eighteen_onlybooleanrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/codes/procedure-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"apply_sales_tax": null,
"category": "string",
"code": "string",
"code_in_claims": "string",
"code_type": "string",
"short_name": "string"
}'curl -X POST "https://api.example.com/api/v1/{org_id}/codes/procedure-codes" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"apply_sales_tax": null,
"category": "string",
"code": "string",
"code_in_claims": "string",
"code_type": "string",
"short_name": "string"
}'/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}/archiveArchive Procedure Code
Parameters
Path Parameters
procedure_code_uuidstringrequiredorg_idstringrequiredResponses
apply_sales_taxbooleanrequiredcategorystringrequiredcodestringrequiredcode_in_claimsstringcode_typestringrequiredcreated_atstring (date-time)requireddefault_billing_orderstringrequireddefault_feestringrequireddeleted_atstring (date-time)descriptionstringrequiredeffective_datestring (date)icd_code_mandatorybooleanrequiredidstring (uuid)requiredis_orthobooleanrequiredlabelstringprovider_mandatorybooleanrequiredprovider_typestringservice_typestringrequiredshort_namestringrequiredsmart_code_logicbooleanrequiredstatusstringrequiredtermination_datestring (date)under_eighteen_onlybooleanrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}Update Explosion Code
Parameters
Path Parameters
explosion_code_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredconditionsobject[]descriptionstringentriesobject[]namestringstatusstringResponses
conditionsobject[]created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringentriesobject[]idstring (uuid)requirednamestringrequiredstatusstringrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"conditions": null,
"description": "string",
"entries": null,
"name": "string"
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/codes/explosion-codes/{explosion_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"conditions": null,
"description": "string",
"entries": null,
"name": "string"
}'/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}Update Procedure Code
Parameters
Path Parameters
procedure_code_uuidstringrequiredorg_idstringrequiredRequest Body
apply_sales_taxbooleanbase_versionintegerrequiredcategorystringcodestringcode_in_claimsstringcode_typestringdefault_billing_orderstringdefault_feenumberdescriptionstringeffective_datestring (date)icd_code_mandatorybooleanis_orthobooleanlabelstringprovider_mandatorybooleanprovider_typestringservice_typestringshort_namestringsmart_code_logicbooleanstatusstringtermination_datestring (date)under_eighteen_onlybooleanResponses
apply_sales_taxbooleanrequiredcategorystringrequiredcodestringrequiredcode_in_claimsstringcode_typestringrequiredcreated_atstring (date-time)requireddefault_billing_orderstringrequireddefault_feestringrequireddeleted_atstring (date-time)descriptionstringrequiredeffective_datestring (date)icd_code_mandatorybooleanrequiredidstring (uuid)requiredis_orthobooleanrequiredlabelstringprovider_mandatorybooleanrequiredprovider_typestringservice_typestringrequiredshort_namestringrequiredsmart_code_logicbooleanrequiredstatusstringrequiredtermination_datestring (date)under_eighteen_onlybooleanrequiredupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"apply_sales_tax": null,
"base_version": 1,
"category": "string",
"code": "string",
"code_in_claims": "string"
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/codes/procedure-codes/{procedure_code_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"apply_sales_tax": null,
"base_version": 1,
"category": "string",
"code": "string",
"code_in_claims": "string"
}'Definitions
9 endpoints
/api/v1/{org_id}/definitionsList Definitions
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
categorystringrequiredpageintegerDefault: 1
page_sizeintegerDefault: 200
is_hiddenbooleansearchstringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/definitions/{definition_uuid}Get Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredResponses
categorystringrequiredcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanrequireditem_colorstringitem_namestringrequireditem_orderintegerrequireditem_valuestringrequiredmetadataobjectupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/definitions/transitionsList definition transitions
List allowed transitions between definitions in a category. Returns all active transitions with from/to definition names. Used for displaying transition rules in the settings UI.
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
categorystringrequiredDefinition category to list transitions for.
Responses
categorystringrequireditemsobject[]requireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/definitions/transitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/definitions/transitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/definitionsCreate Definition
Parameters
Path Parameters
org_idstringrequiredRequest Body
categorystringrequireditem_colorstringitem_namestringrequireditem_orderintegeritem_valuestringmetadataobjectResponses
categorystringrequiredcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanrequireditem_colorstringitem_namestringrequireditem_orderintegerrequireditem_valuestringrequiredmetadataobjectupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"item_color": "string",
"item_name": "string",
"item_order": 1,
"item_value": ""
}'curl -X POST "https://api.example.com/api/v1/{org_id}/definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"item_color": "string",
"item_name": "string",
"item_order": 1,
"item_value": ""
}'/api/v1/{org_id}/definitions/{definition_uuid}/archiveArchive Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredResponses
categorystringrequiredcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanrequireditem_colorstringitem_namestringrequireditem_orderintegerrequireditem_valuestringrequiredmetadataobjectupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/definitions/reorderReorder Definitions
Parameters
Path Parameters
org_idstringrequiredRequest Body
categorystringrequiredordered_uuidsstring (uuid)[]requiredResponses
detailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/definitions/reorder" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"ordered_uuids": []
}'curl -X POST "https://api.example.com/api/v1/{org_id}/definitions/reorder" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"ordered_uuids": []
}'/api/v1/{org_id}/definitions/reset-defaultsReset Definitions
Parameters
Path Parameters
org_idstringrequiredResponses
createdintegerrequiredhiddenintegerrequiredtransitions_resetintegerrequiredupdatedintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/definitions/reset-defaults" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/definitions/reset-defaults" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/definitions/transitionsBulk-replace transitions
Bulk-replace all transitions for a definition category. Soft-deletes all existing transitions for the category, then creates new transitions from the provided pairs. Raises 422 if the category is invalid or any UUID cannot be resolved.
Parameters
Path Parameters
org_idstringrequiredRequest Body
categorystringrequiredDefinition category (e.g., 'LabCaseStatus').
transitionsobject[]requiredComplete set of allowed transitions.
Responses
categorystringrequireditemsobject[]requireddetailobject[]curl -X PUT "https://api.example.com/api/v1/{org_id}/definitions/transitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"transitions": []
}'curl -X PUT "https://api.example.com/api/v1/{org_id}/definitions/transitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"transitions": []
}'/api/v1/{org_id}/definitions/{definition_uuid}Update Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredis_hiddenbooleanitem_colorstringitem_namestringitem_orderintegeritem_valuestringmetadataobjectResponses
categorystringrequiredcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanrequireditem_colorstringitem_namestringrequireditem_orderintegerrequireditem_valuestringrequiredmetadataobjectupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"is_hidden": null,
"item_color": "string",
"item_name": "string",
"item_order": 1
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"is_hidden": null,
"item_color": "string",
"item_name": "string",
"item_order": 1
}'Allergy Definitions
5 endpoints
/api/v1/{org_id}/allergy-definitionsList Allergy Definitions
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
searchstringis_hiddenbooleanResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/allergy-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/allergy-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/allergy-definitions/{definition_uuid}Get Allergy Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringrequiredidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringsnomed_typestringrequiredunii_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/allergy-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/allergy-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/allergy-definitionsCreate Allergy Definition
Parameters
Path Parameters
org_idstringrequiredRequest Body
descriptionstringrequiredinclude_on_medical_historybooleanis_hiddenbooleanis_medical_alertbooleanis_permanentbooleanitem_orderintegersnomed_codestringsnomed_typestringunii_codestringResponses
created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringrequiredidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringsnomed_typestringrequiredunii_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/allergy-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"description": "string",
"include_on_medical_history": true,
"is_hidden": false,
"is_medical_alert": false,
"is_permanent": false
}'curl -X POST "https://api.example.com/api/v1/{org_id}/allergy-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"description": "string",
"include_on_medical_history": true,
"is_hidden": false,
"is_medical_alert": false,
"is_permanent": false
}'/api/v1/{org_id}/allergy-definitions/{definition_uuid}/archiveArchive Allergy Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringrequiredidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringsnomed_typestringrequiredunii_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/allergy-definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1
}'curl -X POST "https://api.example.com/api/v1/{org_id}/allergy-definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1
}'/api/v1/{org_id}/allergy-definitions/{definition_uuid}Update Allergy Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequireddescriptionstringinclude_on_medical_historybooleanis_hiddenbooleanis_medical_alertbooleanis_permanentbooleanitem_orderintegersnomed_codestringsnomed_typestringunii_codestringResponses
created_atstring (date-time)requireddeleted_atstring (date-time)descriptionstringrequiredidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringsnomed_typestringrequiredunii_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/allergy-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"description": "string",
"include_on_medical_history": null,
"is_hidden": null,
"is_medical_alert": null
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/allergy-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"description": "string",
"include_on_medical_history": null,
"is_hidden": null,
"is_medical_alert": null
}'Disease Definitions
5 endpoints
/api/v1/{org_id}/disease-definitionsList Disease Definitions
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
searchstringis_hiddenbooleanResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/disease-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/disease-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/disease-definitions/{definition_uuid}Get Disease Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredResponses
categorystringcreated_atstring (date-time)requireddeleted_atstring (date-time)disease_namestringrequiredicd10_codestringicd9_codestringidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/disease-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/disease-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/disease-definitionsCreate Disease Definition
Parameters
Path Parameters
org_idstringrequiredRequest Body
categorystringdisease_namestringrequiredicd10_codestringicd9_codestringinclude_on_medical_historybooleanis_hiddenbooleanis_medical_alertbooleanis_permanentbooleanitem_orderintegersnomed_codestringResponses
categorystringcreated_atstring (date-time)requireddeleted_atstring (date-time)disease_namestringrequiredicd10_codestringicd9_codestringidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/disease-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"disease_name": "string",
"icd10_code": "string",
"icd9_code": "string",
"include_on_medical_history": true
}'curl -X POST "https://api.example.com/api/v1/{org_id}/disease-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"category": "string",
"disease_name": "string",
"icd10_code": "string",
"icd9_code": "string",
"include_on_medical_history": true
}'/api/v1/{org_id}/disease-definitions/{definition_uuid}/archiveArchive Disease Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredResponses
categorystringcreated_atstring (date-time)requireddeleted_atstring (date-time)disease_namestringrequiredicd10_codestringicd9_codestringidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/disease-definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1
}'curl -X POST "https://api.example.com/api/v1/{org_id}/disease-definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1
}'/api/v1/{org_id}/disease-definitions/{definition_uuid}Update Disease Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredcategorystringdisease_namestringicd10_codestringicd9_codestringinclude_on_medical_historybooleanis_hiddenbooleanis_medical_alertbooleanis_permanentbooleanitem_orderintegersnomed_codestringResponses
categorystringcreated_atstring (date-time)requireddeleted_atstring (date-time)disease_namestringrequiredicd10_codestringicd9_codestringidstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredsnomed_codestringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/disease-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"category": "string",
"disease_name": "string",
"icd10_code": "string",
"icd9_code": "string"
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/disease-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"category": "string",
"disease_name": "string",
"icd10_code": "string",
"icd9_code": "string"
}'Medication Definitions
5 endpoints
/api/v1/{org_id}/medication-definitionsList Medication Definitions
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
searchstringis_hiddenbooleanResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/medication-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/medication-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/medication-definitions/{definition_uuid}Get Medication Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)generic_definitionobjectLightweight reference to a related entity — exposes UUID and optional name.
idstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredmedication_namestringrequirednotesstringrx_cuistringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/medication-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/medication-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/medication-definitionsCreate Medication Definition
Parameters
Path Parameters
org_idstringrequiredRequest Body
generic_definition_uuidstring (uuid)include_on_medical_historybooleanis_hiddenbooleanis_medical_alertbooleanis_permanentbooleanitem_orderintegermedication_namestringrequirednotesstringrx_cuistringResponses
created_atstring (date-time)requireddeleted_atstring (date-time)generic_definitionobjectLightweight reference to a related entity — exposes UUID and optional name.
idstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredmedication_namestringrequirednotesstringrx_cuistringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/medication-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"generic_definition_uuid": "string",
"include_on_medical_history": true,
"is_hidden": false,
"is_medical_alert": false,
"is_permanent": false,
"medication_name": "string"
}'curl -X POST "https://api.example.com/api/v1/{org_id}/medication-definitions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"generic_definition_uuid": "string",
"include_on_medical_history": true,
"is_hidden": false,
"is_medical_alert": false,
"is_permanent": false,
"medication_name": "string"
}'/api/v1/{org_id}/medication-definitions/{definition_uuid}/archiveArchive Medication Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)generic_definitionobjectLightweight reference to a related entity — exposes UUID and optional name.
idstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredmedication_namestringrequirednotesstringrx_cuistringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/medication-definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1
}'curl -X POST "https://api.example.com/api/v1/{org_id}/medication-definitions/{definition_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1
}'/api/v1/{org_id}/medication-definitions/{definition_uuid}Update Medication Definition
Parameters
Path Parameters
definition_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredgeneric_definition_uuidstring (uuid)include_on_medical_historybooleanis_hiddenbooleanis_medical_alertbooleanis_permanentbooleanitem_orderintegermedication_namestringnotesstringrx_cuistringResponses
created_atstring (date-time)requireddeleted_atstring (date-time)generic_definitionobjectLightweight reference to a related entity — exposes UUID and optional name.
idstring (uuid)requiredinclude_on_medical_historybooleanis_hiddenbooleanrequiredis_medical_alertbooleanis_permanentbooleanitem_orderintegerrequiredmedication_namestringrequirednotesstringrx_cuistringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/medication-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"generic_definition_uuid": "string",
"include_on_medical_history": null,
"is_hidden": null,
"is_medical_alert": null
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/medication-definitions/{definition_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"generic_definition_uuid": "string",
"include_on_medical_history": null,
"is_hidden": null,
"is_medical_alert": null
}'Location Groups
15 endpoints
/api/v1/{org_id}/location-groups/divisionsList Divisions
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
statusstringsearchstringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/divisions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/divisions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/divisions/{division_uuid}Get Division
Parameters
Path Parameters
division_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegernamestringrequiredregionsobject[]statusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/divisions/{division_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/divisions/{division_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/groupsList Location Groups
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
statusstringsearchstringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/groups" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/groups" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/groups/{group_uuid}Get Location Group
Parameters
Path Parameters
group_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequiredzip_rangesobject[]detailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/groups/{group_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/groups/{group_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/regionsList Regions
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 50
statusstringsearchstringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/regions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/regions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/regions/{region_uuid}Get Region
Parameters
Path Parameters
region_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/regions/{region_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/location-groups/regions/{region_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/divisionsCreate Division
Parameters
Path Parameters
org_idstringrequiredRequest Body
namestringrequiredregion_uuidsstring (uuid)[]Responses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegernamestringrequiredregionsobject[]statusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/divisions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"region_uuids": []
}'curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/divisions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"region_uuids": []
}'/api/v1/{org_id}/location-groups/divisions/{division_uuid}/archiveArchive Division
Parameters
Path Parameters
division_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegernamestringrequiredregionsobject[]statusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/divisions/{division_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/divisions/{division_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/groupsCreate Location Group
Parameters
Path Parameters
org_idstringrequiredRequest Body
location_uuidsstring (uuid)[]namestringrequiredzip_rangesobject[]Responses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequiredzip_rangesobject[]detailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/groups" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"location_uuids": [],
"name": "string",
"zip_ranges": []
}'curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/groups" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"location_uuids": [],
"name": "string",
"zip_ranges": []
}'/api/v1/{org_id}/location-groups/groups/{group_uuid}/archiveArchive Location Group
Parameters
Path Parameters
group_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequiredzip_rangesobject[]detailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/groups/{group_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/groups/{group_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/regionsCreate Region
Parameters
Path Parameters
org_idstringrequiredRequest Body
location_uuidsstring (uuid)[]namestringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/regions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"location_uuids": [],
"name": "string"
}'curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/regions" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"location_uuids": [],
"name": "string"
}'/api/v1/{org_id}/location-groups/regions/{region_uuid}/archiveArchive Region
Parameters
Path Parameters
region_uuidstringrequiredorg_idstringrequiredResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/regions/{region_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/location-groups/regions/{region_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/location-groups/divisions/{division_uuid}Update Division
Parameters
Path Parameters
division_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequirednamestringregion_uuidsstring (uuid)[]Responses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegernamestringrequiredregionsobject[]statusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/location-groups/divisions/{division_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"name": "string",
"region_uuids": null
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/location-groups/divisions/{division_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"name": "string",
"region_uuids": null
}'/api/v1/{org_id}/location-groups/groups/{group_uuid}Update Location Group
Parameters
Path Parameters
group_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredlocation_uuidsstring (uuid)[]namestringzip_rangesobject[]Responses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequiredzip_rangesobject[]detailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/location-groups/groups/{group_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"location_uuids": null,
"name": "string",
"zip_ranges": null
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/location-groups/groups/{group_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"location_uuids": null,
"name": "string",
"zip_ranges": null
}'/api/v1/{org_id}/location-groups/regions/{region_uuid}Update Region
Parameters
Path Parameters
region_uuidstringrequiredorg_idstringrequiredRequest Body
base_versionintegerrequiredlocation_uuidsstring (uuid)[]namestringResponses
created_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requireditem_orderintegerlocationsobject[]namestringrequiredstatusstringupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/location-groups/regions/{region_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"location_uuids": null,
"name": "string"
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/location-groups/regions/{region_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"base_version": 1,
"location_uuids": null,
"name": "string"
}'Operatories
6 endpoints
/api/v1/{org_id}/operatoriesList operatories
List operatories with optional filters. Staff callers receive the full ``OperatoryListOut`` shape.
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
pageintegerDefault: 1
page_sizeintegerDefault: 100
location_idstringis_hiddenbooleansearchstringResponses
itemsobject[]requiredpageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/operatories" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/operatories" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/operatories/{operatory_uuid}Get operatory by ID
Retrieve a single operatory by UUID. Staff callers receive the full ``OperatoryOut`` shape.
Parameters
Path Parameters
operatory_uuidstringrequiredorg_idstringrequiredResponses
abbreviationstringcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanis_hygienebooleanitem_orderintegerlocationobjectrequiredLightweight reference to a related entity — exposes UUID and optional name.
namestringrequiredoperatory_typeobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_dentistobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_hygienistobjectLightweight reference to a related entity — exposes UUID and optional name.
set_prospectivebooleanupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/operatories/{operatory_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/operatories/{operatory_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/operatories/available-for-slotList available operatories for a time slot
Return operatories that can safely receive the requested appointment slot. This endpoint deliberately exposes the PMS-owned scheduling decision as a non-PHI resolver capability. Agent-MS should use this instead of parsing raw calendar rows or choosing a room from a generic operatory list.
Parameters
Path Parameters
org_idstringrequiredQuery Parameters
location_uuidstringrequiredLocation UUID for the appointment slot.
schedule_datestringrequiredLocal calendar date of the appointment slot.
start_timestringrequiredLocal wall-clock slot start time.
end_timestringrequiredLocal wall-clock slot end time.
appointment_type_uuidstringOptional appointment type UUID used for blockout compatibility checks.
searchstringOptional operatory name search.
pageintegerDefault: 1
page_sizeintegerDefault: 100
Responses
itemsobject[]requiredProvider-ranked operatories available for the requested slot.
pageintegerrequiredpage_sizeintegerrequiredtotalintegerrequireddetailobject[]curl -X GET "https://api.example.com/api/v1/{org_id}/operatories/available-for-slot" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X GET "https://api.example.com/api/v1/{org_id}/operatories/available-for-slot" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/operatoriesCreate Operatory
Parameters
Path Parameters
org_idstringrequiredRequest Body
abbreviationstringis_hiddenbooleanis_hygienebooleanitem_orderintegerlocation_uuidstring (uuid)requirednamestringrequiredoperatory_type_uuidstring (uuid)provider_dentist_uuidstring (uuid)provider_hygienist_uuidstring (uuid)set_prospectivebooleanResponses
abbreviationstringcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanis_hygienebooleanitem_orderintegerlocationobjectrequiredLightweight reference to a related entity — exposes UUID and optional name.
namestringrequiredoperatory_typeobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_dentistobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_hygienistobjectLightweight reference to a related entity — exposes UUID and optional name.
set_prospectivebooleanupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/operatories" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"abbreviation": "string",
"is_hidden": null,
"is_hygiene": null,
"item_order": 1,
"location_uuid": "00000000-0000-0000-0000-000000000000",
"name": "string"
}'curl -X POST "https://api.example.com/api/v1/{org_id}/operatories" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"abbreviation": "string",
"is_hidden": null,
"is_hygiene": null,
"item_order": 1,
"location_uuid": "00000000-0000-0000-0000-000000000000",
"name": "string"
}'/api/v1/{org_id}/operatories/{operatory_uuid}/archiveArchive Operatory
Parameters
Path Parameters
operatory_uuidstringrequiredorg_idstringrequiredResponses
abbreviationstringcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanis_hygienebooleanitem_orderintegerlocationobjectrequiredLightweight reference to a related entity — exposes UUID and optional name.
namestringrequiredoperatory_typeobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_dentistobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_hygienistobjectLightweight reference to a related entity — exposes UUID and optional name.
set_prospectivebooleanupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X POST "https://api.example.com/api/v1/{org_id}/operatories/{operatory_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"curl -X POST "https://api.example.com/api/v1/{org_id}/operatories/{operatory_uuid}/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"/api/v1/{org_id}/operatories/{operatory_uuid}Update Operatory
Parameters
Path Parameters
operatory_uuidstringrequiredorg_idstringrequiredRequest Body
abbreviationstringbase_versionintegerrequiredis_hiddenbooleanis_hygienebooleanitem_orderintegerlocation_uuidstring (uuid)namestringoperatory_type_uuidstring (uuid)provider_dentist_uuidstring (uuid)provider_hygienist_uuidstring (uuid)set_prospectivebooleanResponses
abbreviationstringcreated_atstring (date-time)requireddeleted_atstring (date-time)idstring (uuid)requiredis_hiddenbooleanis_hygienebooleanitem_orderintegerlocationobjectrequiredLightweight reference to a related entity — exposes UUID and optional name.
namestringrequiredoperatory_typeobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_dentistobjectLightweight reference to a related entity — exposes UUID and optional name.
provider_hygienistobjectLightweight reference to a related entity — exposes UUID and optional name.
set_prospectivebooleanupdated_atstring (date-time)requiredversionintegerrequireddetailobject[]curl -X PATCH "https://api.example.com/api/v1/{org_id}/operatories/{operatory_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"abbreviation": "string",
"base_version": 1,
"is_hidden": null,
"is_hygiene": null,
"item_order": 1
}'curl -X PATCH "https://api.example.com/api/v1/{org_id}/operatories/{operatory_uuid}" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"abbreviation": "string",
"base_version": 1,
"is_hidden": null,
"is_hygiene": null,
"item_order": 1
}'