Predict visit codes

POST

/api/prices/v1/treatments

POST

/api/prices/v1/treatments

import requests
url = "https://api.taigabilling.com/api/prices/v1/treatments"
payload = {
    "appointment": {
        "type": "string",
        "value": { "type": "string" }
    },
    "billing_provider_npi": {
        "0": "s",
        "1": "t",
        "2": "r",
        "3": "i",
        "4": "n",
        "5": "g",
        "value": "string"
    },
    "patient": {
        "reference": "string",
        "value": { "reference": "string" }
    }
}
headers = {
    "Idempotency-Key": "Idempotency-Key",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "candidates": [
    {
      "code": "string",
      "modifiers": [
        "string"
      ],
      "probability": 0.5,
      "selection": "string",
      "treatment_name": "string"
    }
  ],
  "created_at": "2024-01-15T09:30:00Z",
  "id": "string",
  "livemode": true,
  "object": "treatment_prediction",
  "predicted": [
    {
      "code": "string",
      "modifiers": [
        "string"
      ],
      "probability": 0.5,
      "selection": "string",
      "treatment_name": "string"
    }
  ],
  "model_version": "string",
  "selection_mode": "string"
}

Predicts the procedure codes for an upcoming visit without pricing it. Price the result by sending its id as treatments.trt_id to the create-price endpoint.

Authentication

AuthorizationBearer

Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

Request

This endpoint expects an object.

appointmentobjectRequired

billing_provider_npistringRequiredformat: "^\d{10}$"

patientobjectRequired

insuranceobjectOptional

max_candidatesintegerOptional1-10

Defaults to 5.

providerobjectOptional

Response

Prediction

candidateslist of objects

Further likely codes, best first.

created_atdatetime

idstring

Send as treatments.trt_id to price this prediction.

livemodeboolean

objectenum

Allowed values:

predictedlist of objects

The codes expected for the visit.

model_versionstring or nullOptional

selection_modestring or nullOptional

model, route or suppressed.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

502

Bad Gateway Error

Authentication

Headers

Request

Response

Errors