Create a price

POST

/api/prices/v1

POST

/api/prices/v1

import requests
url = "https://api.taigabilling.com/api/prices/v1"
payload = {
    "billing_provider_npi": "1669095808",
    "insurances": [
        {
            "member_id": "W123456789",
            "payer_id": "60054",
            "state": "NY"
        }
    ],
    "patient": {
        "dob": "1984-04-04",
        "first_name": "Jane",
        "last_name": "Doe",
        "reference": "patient-001"
    },
    "provider": {
        "last_name": "Smith",
        "npi": "1234567893"
    },
    "items": [
        {
            "code": "99213",
            "modifiers": []
        },
        {
            "code": "80053",
            "modifiers": []
        }
    ]
}
headers = {
    "Idempotency-Key": "Idempotency-Key",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "created_at": "2024-01-15T09:30:00Z",
  "id": "string",
  "livemode": true,
  "mode": "codes_provided",
  "object": "price",
  "status": "processing",
  "add_ons": [
    {
      "adjustments": [
        {
          "amount": 1,
          "type": "copay"
        }
      ],
      "allowed": 1,
      "code": "string",
      "id": "string",
      "modifiers": [
        "string"
      ],
      "patient_responsibility": 1,
      "pricing_basis": "string",
      "probability": 1.1,
      "status": "string",
      "treatment": {
        "name": "string"
      }
    }
  ],
  "alternatives": [
    {
      "adjustments": [
        {
          "amount": 1,
          "type": "copay"
        }
      ],
      "allowed": 1,
      "code": "string",
      "id": "string",
      "modifiers": [
        "string"
      ],
      "patient_responsibility": 1,
      "pricing_basis": "string",
      "probability": 1.1,
      "status": "string",
      "treatment": {
        "name": "string"
      }
    }
  ],
  "base": {
    "items": [
      {
        "adjustments": [
          {
            "amount": 1,
            "type": "copay"
          }
        ],
        "allowed": 1,
        "code": "string",
        "id": "string",
        "modifiers": [
          "string"
        ],
        "patient_responsibility": 1,
        "pricing_basis": "string",
        "probability": 1.1,
        "status": "string",
        "treatment": {
          "name": "string"
        }
      }
    ]
  },
  "disclosure": "string",
  "error": {
    "code": "string",
    "message": "string",
    "type": "string"
  },
  "insurances": [
    {
      "accumulators": {
        "deductible_remaining": 1,
        "oop_max_remaining": 1,
        "plan_deductible": 1,
        "plan_oop_max": 1
      },
      "network": "string",
      "payer_id": "string",
      "priority": "primary",
      "status": "string"
    }
  ],
  "references": {
    "appointment": "string",
    "patient": "string"
  },
  "service_date": "2023-01-15",
  "totals": {
    "base": 1,
    "base_plus_add_ons_max": 1,
    "priced_items": 1,
    "unpriced_items": 1
  }
}

Prices a visit’s patient responsibility before it happens. Pricing must be enabled for the credential’s organization in the target environment. Answers 200 with the finished price, or 202 while it is still processing; use price readback to check its status.

For staging, send the sandbox example below to https://api-staging.taigabilling.com with a staging API key and a billing_provider_npi in its scope. Use sandbox payer SBX01 and member SBX-ACTIVE for an active-coverage test; find supported payer identifiers with payer lookup. A sandbox price has livemode: false.

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.

billing_provider_npistringRequiredformat: "^\d{10}$"

insuranceslist of objectsRequired

Primary first, then an optional secondary.

patientobjectRequired

providerobjectRequired

appointmentobjectOptional

itemslist of objectsOptional

service_datedateOptional

treatmentsobjectOptional

Response

Price

created_atdatetime

idstring

livemodeboolean

false for test prices built from synthetic data.

modeenum

Allowed values:

objectenum

Allowed values:

statusenum

Allowed values:

add_onslist of objects or nullOptional

Codes that may be billed in addition to the base visit.

alternativeslist of objects or nullOptional

Codes that may be billed instead of a base line.

baseobject or nullOptional

The expected visit, present once the price completes.

disclosurestring or nullOptional

Text that must be shown to the patient verbatim.

errorobjectOptional

Present only when status is failed.

insuranceslist of objects or nullOptional

Coverage verification outcome, in request order.

referencesobjectOptional

service_datedate or nullOptional

totalsobject or nullOptional

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