---
title: "Analyse business rules violations for line items"
method: POST
path: "/api/v1/business_rules_analysis/analyse_line_items"
---

# Analyse business rules violations for line items

`POST /api/v1/business_rules_analysis/analyse_line_items`

Analyses a list of line items for business rules violations against participant data

## Request body

- BusinessRulesAnalysisRequest — Request schema for analysing business rules violations for line items
  - `line_items` LineItemInput[], required
    - `id` integer, nullable
    - `cancellation` boolean, nullable
    - `claim_type` string, required
    - `description` string, required
    - `early_childhood` boolean, nullable
    - `line_total` number, required
    - `quantity` number, required
    - `service_date_from` string, nullable
    - `service_date_to` string, nullable
    - `service_item_number` string, nullable
    - `service_type` string, nullable
    - `time_from` integer, nullable
    - `time_to` integer, nullable
    - `unit_price` number, nullable
    - `line_tax` number, nullable
    - `method` string, nullable
    - `line_total_valid` boolean, nullable
    - `gst_code` string, nullable
    - `fallback_data` object[], nullable
    - `has_business_violations` boolean, nullable
    - `business_violation_messages` string[], nullable
    - `business_violation_types` string[], nullable
    - `page_number` integer, nullable
    - `coordinates` object, nullable
  - `participant_id` string, required
  - `provider_id` string, nullable
  - `update_database` boolean, nullable

## Response `200`

Successful Response

- BusinessRulesAnalysisResponse — Response schema for business rules analysis
  - `violations_found` boolean, required
  - `line_items` object[], required
  - `violations_summary` ViolationSummary, required — Summary of violations found during analysis
    - `total_violations` integer, required
    - `general_violations` integer, required
    - `pace_violations` integer, required
    - `sap_violations` integer, required
    - `price_guide_violations` integer, required
    - `violation_types` object, required
  - `participant_info` AppSchemasBusinessRulesAnalysisParticipantInfo — Information about the participant for analysis context
    - `is_pace_plan` boolean, nullable, required
    - `has_budget_data` boolean, required
    - `has_service_bookings` boolean, required
  - `analysis_error` boolean, nullable
  - `database_updated` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/caresquare/apis/fastapi.md) · [All operations](https://skmtc.dev/caresquare/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/caresquare/fastapi/revisions/c9df874d8d59/schema)