Update universal service line

Authorization

BearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

service_line_id*ServiceLineId

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

revenue_code?|

A 4 digit code that specifies facility department or type of service arrangement for institutional service line items (837i). This code is not required for professional claim billing (837p).

diagnosis_id_zero?|null

diagnosis_id_one?|null

diagnosis_id_two?|null

diagnosis_id_three?|null

edit_reason?string|null

modifiers?array<>|null

charge_amount_cents?|

The total amount charged for this service line, factoring in quantity. If procedure_code is updated and this is not, the system will attempt to set it based on chargemasters entries and the service line’s quantity. For example, if a single unit has an entry of 100 cents and 2 units were rendered, the charge_amount_cents will be set to 200, if there is no chargemaster entry, it will default to the amount set in this field.

drug_identification?|null

denial_reason?|null

place_of_service_code?|

837p Loop2300, SV105. This enum is not used or required in 837i claims. If your organization does not intend to submit claims with a different place of service at the service line level, this field should not be populated. 02 for telemedicine, 11 for in-person. Full list here.

units?|null

procedure_code?|

If procedure_code is updated, and charge_amount_cents is not, then charge_amount_cents will be set by the system. Pass null to uncode the service line, which is valid for institutional (837i) claims that bill by revenue code rather than a CPT/HCPCS code.

quantity?|

String representation of a Decimal that can be parsed by most libraries. For professional claims, a ServiceLine quantity cannot contain more than one digit of precision (Example: 1.1 is valid, 1.11 is not). For institutional claims, a ServiceLine quantity cannot contain more than three decimal digits of precision.

description?|

A free-form description to clarify the related data elements and their content. Maps to SV1-01, C003-07 on a 837-P and SV2-02, C003-07 on a 837-I form.

date_of_service?|

date_of_service must be defined on either the encounter or the service lines but not both.

Formatdate

end_date_of_service?|

Formatdate

test_results?array<>|

Contains a list of test results. Test result types may map to MEA-02 on the 837-P (ex: Hemoglobin, Hematocrit). This is unused by 837-i and ignored for institutional service lines. No more than 5 MEA-02 test results may be submitted per service line. Updating test results utilizes PUT semantics, so the test results on the service line will be set to whatever inputs are provided.

has_epsdt_indicator?|

Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500. If the value is true, the box will be populated with “Y”. Otherwise, the box will not be populated. This box is not used on an 837i.

has_family_planning_indicator?|

Maps to SV1-12 on the 837-P and Box 24I on the CMS-1500. If the value is true, the box will be populated with "Y". Otherwise, the box will not be populated.

note?|

Maps to NTE02 loop 2400 on the EDI 837.

prior_authorization_number?|

Prior authorization number for this service line. Maps to the appropriate REF segment on Loop 2400 of the EDI 837p. This is not used for institutional claims (EDI 837i).

external_id?|

An external identifier for this service line. This is not used in the EDI 837, but can be used to identify the service line in external systems. This field should not contain PHI. Must be unique on a given claim.

Response Body

`application/json`

curl -X PATCH "https://example.com/api/service-lines/v2/497f6eca-6276-4993-bfeb-53cbbbba6f08/universal" \  -H "Content-Type: application/json" \  -d '{}'

{  "created_at": "2023-01-01T00:00:00Z",  "modifiers": [    "AV"  ],  "charge_amount_cents": 0,  "allowed_amount_cents": 0,  "insurance_balance_cents": 0,  "patient_balance_cents": 0,  "paid_amount_cents": 0,  "primary_paid_amount_cents": 0,  "secondary_paid_amount_cents": 0,  "tertiary_paid_amount_cents": 0,  "patient_responsibility_cents": 0,  "copay_cents": 0,  "coinsurance_cents": 0,  "deductible_cents": 0,  "diagnosis_id_zero": "f0fef26d-b316-4adc-b36b-8de9eb0c937b",  "diagnosis_id_one": "06f8cea7-70fe-4c7c-8160-1b76eba0a401",  "diagnosis_id_two": "a6faa11d-f54e-4d73-876b-28911a593769",  "diagnosis_id_three": "8ab279cc-d7d5-4b13-b283-309cad42c284",  "drug_identification": {    "service_id_qualifier": "EN",    "national_drug_code": "string",    "national_drug_unit_count": "string",    "measurement_unit_code": "ML",    "link_sequence_number": "string",    "pharmacy_prescription_number": "string",    "conversion_formula": "string",    "drug_description": "string"  },  "service_line_era_data": {    "service_line_adjustments": [      {        "created_at": "2019-08-24T14:15:22Z",        "adjustment_group_code": "string",        "adjustment_reason_code": "string",        "adjustment_amount_cents": 0,        "adjustment_note": "string"      }    ],    "remittance_advice_remark_codes": [      "string"    ]  },  "service_line_manual_adjustments": [    {      "created_at": "2019-08-24T14:15:22Z",      "adjustment_group_code": "string",      "adjustment_reason_code": "string",      "adjustment_amount_cents": 0,      "adjustment_note": "string"    }  ],  "related_invoices": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "organzation_id": "6b7e4588-f600-4079-894b-c4ac282ac6b3",      "source_id": "string",      "source_customer_id": "string",      "patient_external_id": "string",      "note": "string",      "due_date": "string",      "status": "draft",      "url": "string",      "customer_invoice_url": "string",      "items": [        {          "service_line_id": "a87d8c62-6b36-44c6-9f01-a675dd3707d1",          "amount_cents": 0        }      ]    }  ],  "related_invoice_info": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "invoice": {        "amount_cents": 0,        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z",        "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",        "invoice_destination_metadata": {          "invoice_destination": "STRIPE",          "source_id": "string",          "source_customer_id": "string",          "destination_status": "string"        },        "patient_external_id": "string",        "note": "string",        "due_date": "2019-08-24",        "status": "DRAFT",        "url": "string",        "customer_invoice_url": "string",        "items": {          "claim_invoice_items": {            "property1": {              "claim_invoice_item": {                "claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",                "amount_cents": 0              },              "service_line_invoice_items": {                "property1": {                  "service_line_id": "a87d8c62-6b36-44c6-9f01-a675dd3707d1",                  "amount_cents": 0                },                "property2": {                  "service_line_id": "a87d8c62-6b36-44c6-9f01-a675dd3707d1",                  "amount_cents": 0                }              }            },            "property2": {              "claim_invoice_item": {                "claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",                "amount_cents": 0              },              "service_line_invoice_items": {                "property1": {                  "service_line_id": "a87d8c62-6b36-44c6-9f01-a675dd3707d1",                  "amount_cents": 0                },                "property2": {                  "service_line_id": "a87d8c62-6b36-44c6-9f01-a675dd3707d1",                  "amount_cents": 0                }              }            }          },          "unattributed_items": [            {              "amount_cents": 0            }          ]        }      },      "invoice_type": "STRIPE"    }  ],  "denial_reason": {    "reason": "Authorization Required"  },  "place_of_service_code": "01",  "place_of_service_code_as_submitted": "01",  "service_line_id": "a87d8c62-6b36-44c6-9f01-a675dd3707d1",  "procedure_code": "99213",  "ordering_provider": {    "provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44",    "address": {      "zip_plus_four_code": "1234",      "address1": "string",      "address2": "string",      "city": "string",      "state": "AA",      "zip_code": "string"    },    "tax_id": "string",    "npi": "1234567890",    "taxonomy_code": "string",    "qualifier": "DQ",    "provider_commercial_license_type": "0",    "secondary_identification": {      "reference_identification": "string",      "reference_identification_qualifier": "0B"    },    "first_name": "string",    "last_name": "string",    "organization_name": "string"  },  "revenue_code": "string",  "quantity": "string",  "units": "MJ",  "claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",  "date_of_service_range": {    "start_date": "string",    "end_date": "string"  },  "description": "string",  "date_of_service": "2023-01-01",  "end_date_of_service": "2019-08-24",  "test_results": [    {      "value": 0.1,      "result_type": "HEMATOCRIT"    }  ],  "has_epsdt_indicator": true,  "has_family_planning_indicator": true,  "note": "string",  "prior_authorization_number": "string",  "external_id": "string"}

Authorization

Path Parameters

Request Body

Response Body

200application/json

403application/json

404application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`