Create encounter pre-service run

POST

/api/pre-service/v1/runs/encounter

POST

/api/pre-service/v1/runs/encounter

import requests
url = "https://api.taigabilling.com/api/pre-service/v1/runs/encounter"
payload = {
    "entity": {
        "external_id": "enc-123",
        "patient_authorized_release": True,
        "benefits_assigned_to_provider": True,
        "provider_accepts_assignment": True,
        "patient": {
            "address": {
                "address1": "1 Main St",
                "city": "Fairfax",
                "state": "VA",
                "zip_code": "22031"
            },
            "date_of_birth": "1960-01-01",
            "external_id": "p-456",
            "first_name": "Jane",
            "gender": "female",
            "last_name": "Doe"
        },
        "responsible_party": "INSURANCE_PAY",
        "billing_provider": {
            "address": {
                "address1": "1 Main St",
                "city": "Fairfax",
                "state": "VA",
                "zip_code": "22031",
                "zip_plus_four_code": "4634"
            },
            "npi": "1558375857",
            "tax_id": "202265068",
            "organization_name": "Example Clinic"
        },
        "date_of_service": "2026-10-15",
        "service_lines": [
            {
                "quantity": "1",
                "units": "UN",
                "charge_amount_cents": 20600,
                "diagnosis_pointers": [0],
                "procedure_code": "99213"
            }
        ],
        "health_care_code_information": { "principal_diagnosis": {
                "principal_diagnosis_code_qualifier": "ABK",
                "primary_diagnosis_code": "Z01.411"
            } },
        "submission_expectation": "TARGET_PROFESSIONAL",
        "subscriber_primary": {
            "first_name": "Jane",
            "gender": "female",
            "insurance_card": {
                "member_id": "123456789",
                "payer_id": "12345",
                "payer_name": "Example Payer"
            },
            "last_name": "Doe",
            "patient_relationship_to_subscriber_code": "18"
        },
        "rendering_provider": {
            "npi": "1234567893",
            "first_name": "Ada",
            "last_name": "Lovelace"
        }
    },
    "pipeline_id": "pre-service-claim-athena",
    "enabled_rule_ids": [],
    "disabled_rule_ids": [],
    "idempotency_key": "enc-123-run-1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

"0192a6f4-7c1e-7b3a-9d2e-5f8a1c3b4d6e"

Submit a representation of an encounter to the Taiga rules engine. Note that this encounter will not be created in Taiga. Returns a run_id that can be polled via GET /runs/{run_id} to retrieve the results once complete.

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.

entityobjectRequired

The encounter to evaluate against the rules engine.

pipeline_idstringRequired

Identifies the set of rules to run against the encounter.

enabled_rule_idslist of stringsRequired

IDs of disabled rules to force-enable for this run (e.g. for testing new rules).

disabled_rule_idslist of stringsRequired

IDs of enabled rules to force-disable for this run (e.g., to “override” or skip certain rules).

idempotency_keystringRequired

Prevents multiple rule runs from being dispatched in response to duplicate requests.

Response

Errors

403

Forbidden Error

422

Unprocessable Entity Error