Skip to navigation

Taiga Partner API

Build against Taiga's billing API with scoped partner credentials.

The Taiga Partner API lets approved partner organizations work with billing data programmatically. The API uses Taiga-issued API keys and your organization’s configured billing-provider NPI scope.

What's in these docs?

Use the guides for the workflow around the API: authentication, request shape, tenant scoping, pagination, and errors. Use the API Reference for exact endpoint paths, request bodies, response schemas, and generated request examples.

Start here

OpenAPI spec

The full machine-readable spec for every endpoint, request body, and response schema is published at https://api.taigabilling.com/openapi.json.

curl https://api.taigabilling.com/openapi.json -o taiga-partner-openapi.json

Base URLs

SurfaceURL
Partner APIhttps://api.taigabilling.com
Staging APIhttps://api-staging.taigabilling.com
OpenAPI spechttps://api.taigabilling.com/openapi.json
Developer portalhttps://app.taigabilling.com/developers

How access works

Your organization must have developer access enabled in Taiga. Once enabled, users in your organization can create API keys from the developer portal.

Each API key belongs to one Taiga organization. Requests made with that key are scoped to that organization’s configured billing-provider NPIs. You do not pass an organization override in API requests.

Typical integration flow

Create API key Authorization header Create patient Create coverage with patient Versioned filing_order update pre_encounter_patient_id BILLABLE begins processing Scoped reads OpenAPI spec Developer portal API key Taiga Partner API Patient record Coverage record Insured patient record Create encounter Billing workflow Billing data Generated SDK
1

Create an API key

Sign in to the developer portal and add an API key.

2

Call the API

Send requests with Authorization: Bearer <api key>. Tenancy is enforced server-side.

3

Create the patient before the encounter

Register the patient with POST /patients/v1, create their insurance with POST /coverages/v1 using the patient field, then add the returned coverage id to the patient’s filing_order.coverages with a versioned PUT /patients/v1/{id}/{version}. Encounters reference the resulting patient record; the patients-first sequence walks through each call.

4

Create encounters from the patient

Call POST /api/encounters/v4/create-from-pre-encounter with the patient’s pre_encounter_patient_id; demographics and coverage are pulled from the patient record. Non-telehealth encounters must include a service facility, and each applicable service line must carry its prior-authorization number. Use BILLABLE only when the encounter is ready for immediate billing processing; validation blockers can still require action before submission.

5

Paginate lists

Use limit and follow next_page_token until it is empty.

6

Generate a client

Download openapi.json and produce a typed SDK in your language of choice.