⚠️ Mandatory iTero API Migration Deadline by October 31st ⚠️
Update your application to comply with the new integration guidelines listed here
Failure to do so will result in loss of API access and service interruption.

Rx Definition

All restorative and orthodontic cases include information that helps partners understand the patient's specific treatment plan.

In order to understand the iTero terminology, a comprehensive list of the restorative options and definitions is provided in a JSON file.

Mapping iTero definitions to your software's own definitions allows for a deeper integration between the two systems.

Note

Click to download the JSON file, or right-click and choose “Open in new tab” to view it directly in your browser.

Remember

Parsing an Rx is possible through two ways:

  • Downloading the IDE and parsing the XML file
  • Using the Get Full Rx endpoint and parsing the JSON file
  • The ‘isActive’ property of implants refers to an internal iTero status. Partners are free to only map the active implants; however, if they face an unknown ‘implant type’ the program should still reference the complete table to get the type (even if it’s inactive) for backwards compatibility.


Below is a high-level overview of the Rx Definition schema:

{
    "AbutmentTypes": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "DentureGingivalShades": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "DentureMoulds": [
        {
            "Id": int,
            "Name": "string"
        },
        ... 
    ],
    "DentureStages": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "DentureShadeSystems": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "ImplantBasedRestorationTypes": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "ImplantsData": {
        "ScanBodyManufacturers": [
            {
                "Id": int,
                "Name": "string"
            },
            ...
        ],
        "ImplantManufacturers": [
            {
                "Id": int,
                "Name": "string"
            },
            ...
        ],
        "Implants": [
            {
                "IsActive": boolean,
                "ImplantManufacturerId": int,
                "ScanBodyManufacturerId": int,
                "Id": int,
                "Name": "string"
            },
            ...
        ]
    },
    "Materials": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "PonticDesign": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "Procedures": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "ProcedureTypes": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "Specifications": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "ShadeSystems": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "ToothInBridgeTypes": [{
            "Id": int,
            "Name": "string"
        },        
        ...
    ],
    "TreatmentStages": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ],
    "UnitTypeNames": [
        {
            "Id": int,
            "Name": "string"
        },
        ...
    ]
}