{"openapi":"3.1.0","info":{"title":"Partner Exchange API","description":"\n## WorkFINITY® Solution Configuration Management System — Partner Exchange AI API\n\nA high-performance enterprise REST API for managing partner directory profiles, exchange offers, individual company offers, dynamic reference forms, and business rule associations over BPRM.\n\n---\n\n### 🔑 Authentication\nMost endpoints in this microservice require internal service authentication.\nClick the green **Authorize 🔓** button in Swagger UI and provide your credentials:\n- **`X-Internal-Auth`**: Internal service secret (`<INTERNAL_SERVICE_SECRET>`)\n- **`AppId (X-App-Id)`**: Application GUID context for multi-tenant data operations\n\nSwagger UI automatically persists your authorization credentials across page reloads.\n\nPublic diagnostic endpoints (`/health` and `/db-ping`) do not require authentication.\n\n---\n\n### 🧱 Hierarchy & Database Tables Schema\n- **`dbo.Partner` (Partner Directory)**: Core partner registry capturing partner identity, legal business name, partner code, partner classification type, contact information, and active lifecycle status (`IsActive`).\n- **`dbo.Offer` (Offers & Master Agreements)**: Parent exchange offers and promotional arrangements. An offer is `Individual` (no partners) or `Partner` (`OfferKind`); a Partner offer has many partners in `dbo.OfferPartner`. Offer rules (`dbo.OfferRule`) keep the offer's own right-hand values, for the offer and for each additional offer. Captures validity periods, default JSON values, and pinned reference forms (`FormDefinitionId`, `FormDefinitionVersionId`).\n- **`dbo.AdditionalOffer` (Sub-offers & Add-ons)**: Hierarchical child add-on offers linked directly to a parent offer via `OfferId`. Includes independent schema overrides, order sequencing, and custom reference form bindings.\n- **`dbo.FormDefinitions`**: Dynamic form and UI schema definitions linked to offers to provide automated data collection surfaces.\n- **`dbo.OfferRule` & `dbo.RuleDefinition`**: Associated business and pricing rules evaluated against partner agreements and offer terms.\n\n---\n\n### 🤝 Partner & Offer Ecosystem\n- **Partner Profile Management**: Full CRUD operations with soft deactivation guards and active state toggling (`/api/partners`, `/api/partners/{id}/toggle-active`).\n- **Partner Exchange Offers**: Creation, configuration, date validation, active toggling, search filtering, and reference form attachments (`/api/offers`).\n- **Direct Individual Offers**: Application-scoped exchange offers independent of third-party partners (`/api/offers/individual`).\n- **Additional Offers (Add-ons)**: Direct canonical resource management and child sub-offers (`/api/additional-offers`, `/api/offers/{id}/additional-offers`).\n- **Complete Relationship Trees**: Instant retrieval of nested partner and offer hierarchies (`/api/partners/{id}/tree`, `/api/offers/{id}/tree`).\n- **Cross-Service Relationship Lookups**: Query active business rules and offers bound to partners and offers (`/api/partners/{id}/offers`, `/api/partners/{id}/rules`, `/api/offers/{id}/rules`).\n- **Automated Data Quality & Remediation**: Comprehensive diagnostics and auto-deactivation for duplicate codes, orphan relationships, and date range validity anomalies (`/api/data-quality`, `/api/dq-scan`, `/api/data-quality/deactivate-expired`).\n- **Global Search & Executive Dashboard**: Universal substring search (`/api/search`) and real-time operational KPI counts (`/api/summary`).\n- **Bulk Data Transfer**: Export partner profiles, exchange offers, and additional offers across JSON and CSV formats (`/api/export/partners`, `/api/export/offers`, `/api/export/additional-offers`).\n","termsOfService":"https://workfinity.net/terms","contact":{"name":"WorkFINITY Support","url":"https://workfinity.net/","email":"support@workfinity.net"},"license":{"name":"Proprietary","url":"https://workfinity.net/"},"version":"1.0.0"},"servers":[{"url":"/","description":"Current Server (Auto-detected)"},{"url":"http://localhost:8000","description":"Local Development (Port 8000)"},{"url":"http://localhost:5000","description":"Local Development (Port 5000)"},{"url":"http://localhost:5004","description":"Partner AI API (Port 5004)"},{"url":"https://partner-ai-portal.workfinity.com","description":"Production Portal"}],"paths":{"/api/partners":{"get":{"tags":["Partners"],"summary":"List partners","description":"Retrieve a paginated list of partners from `dbo.Partner` with optional filtering by name, type, and inactive status.","operationId":"api_list_partners_api_partners_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"pageSize","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200,"minimum":1},{"type":"null"}],"description":"Items per page (max 200)","title":"Pagesize"},"description":"Items per page (max 200)"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching partner name","title":"Name"},"description":"Optional filter matching partner name"},{"name":"partnerType","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching partner classification type","title":"Partnertype"},"description":"Optional filter matching partner classification type"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated partners","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated partners"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Page_PartnerOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Partners"],"summary":"Create partner","description":"Create a new partner definition record in `dbo.Partner` with partner code, type, contact details, and application scoping.","operationId":"api_create_partner_api_partners_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerCreate"}}}},"responses":{"201":{"description":"Partner successfully created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PartnerOut_"}}}},"400":{"description":"Invalid partner payload or validation failure"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/partners/import":{"post":{"tags":["Partners"],"summary":"Import partners from a file","description":"Creates partners in `dbo.Partner` from a CSV or JSON file (docs/import-templates/08-partners.csv). Columns: Name and PartnerCode (required), PartnerType, Email, PhoneNumber, Address, Description, IsActive. A PartnerCode the application already has is skipped; each failed row is reported with its row number. Use dryRun=true to validate only.","operationId":"api_import_partners_api_partners_import_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"applicationId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Application GUID (or send X-App-Id)","title":"Applicationid"},"description":"Application GUID (or send X-App-Id)"},{"name":"dryRun","in":"query","required":false,"schema":{"type":"boolean","description":"Validate and report without saving","default":false,"title":"Dryrun"},"description":"Validate and report without saving"},{"name":"createdByUserId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Creator UserAccount GUID","title":"Createdbyuserid"},"description":"Creator UserAccount GUID"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_api_import_partners_api_partners_import_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportResult"}}}},"404":{"description":"Application not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/partners/{id}":{"get":{"tags":["Partners"],"summary":"Get partner by ID","description":"Retrieve full details for a specific partner entity by its UUID from `dbo.Partner`.","operationId":"api_get_partner_api_partners__id__get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Partner details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PartnerOut_"}}}},"404":{"description":"Partner not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Partners"],"summary":"Update partner","description":"Update an existing partner record in `dbo.Partner` by UUID.","operationId":"api_update_partner_api_partners__id__put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerUpdate"}}}},"responses":{"200":{"description":"Partner successfully updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PartnerOut_"}}}},"404":{"description":"Partner not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Partners"],"summary":"Deactivate partner","description":"Soft-deactivate a partner in `dbo.Partner` by setting `IsActive = 0`.","operationId":"api_delete_partner_api_partners__id__delete","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Partner successfully deactivated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_"}}}},"404":{"description":"Partner not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/partners/{id}/toggle-active":{"patch":{"tags":["Partners"],"summary":"Toggle partner active state","description":"Toggle active status (`IsActive`) for a partner profile in `dbo.Partner`.","operationId":"api_toggle_partner_api_partners__id__toggle_active_patch","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Partner active state updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PartnerOut_"}}}},"404":{"description":"Partner not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/partners/{id}/tree":{"get":{"tags":["Hierarchy"],"summary":"Get complete partner hierarchy tree","description":"Retrieve the complete nested relationship tree for a partner: Partner profile, all associated Exchange Offers, child Additional Offers, and bound business Rules.","operationId":"api_get_partner_tree_api_partners__id__tree_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Complete partner hierarchy tree","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PartnerHierarchyTreeResponse_"}}}},"404":{"description":"Partner not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/individual":{"get":{"tags":["Offers"],"summary":"List individual company offers","description":"Retrieve a paginated list of direct individual/company exchange offers from `dbo.Offer` (`OfferKind = 'Individual'`).","operationId":"api_list_individual_offers_api_offers_individual_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":10,"title":"Pagesize"},"description":"Items per page (max 200)"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching offer name","title":"Name"},"description":"Optional filter matching offer name"},{"name":"offerCode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching offer code","title":"Offercode"},"description":"Optional filter matching offer code"},{"name":"offerType","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching offer classification type","title":"Offertype"},"description":"Optional filter matching offer classification type"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated individual offers","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated individual offers"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Page_OfferOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Offers"],"summary":"Create individual company offer","description":"Create a new direct individual/company exchange offer in `dbo.Offer` (`OfferKind = 'Individual'`, no partners).","operationId":"api_create_individual_offer_api_offers_individual_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferCreate"}}}},"responses":{"201":{"description":"Individual company offer created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/individual/{id}":{"put":{"tags":["Offers"],"summary":"Update individual company offer","description":"Update an existing direct individual/company exchange offer in `dbo.Offer`.","operationId":"api_update_individual_offer_api_offers_individual__id__put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferUpdate"}}}},"responses":{"200":{"description":"Individual company offer updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers":{"get":{"tags":["Offers"],"summary":"List partner offers","description":"Retrieve a paginated list of partner exchange offers from `dbo.Offer` (`OfferKind = 'Partner'`), with optional search and filtering.","operationId":"api_list_exchange_offers_api_offers_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":10,"title":"Pagesize"},"description":"Items per page (max 200)"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching offer name","title":"Name"},"description":"Optional filter matching offer name"},{"name":"offerCode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching offer code","title":"Offercode"},"description":"Optional filter matching offer code"},{"name":"offerType","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching offer classification type","title":"Offertype"},"description":"Optional filter matching offer classification type"},{"name":"partnerId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional filter by partner UUID","title":"Partnerid"},"description":"Optional filter by partner UUID"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated exchange offers","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated exchange offers"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Page_OfferOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Offers"],"summary":"Create partner offer","description":"Create a Partner offer in `dbo.Offer` with one or more partners (`PartnerIds`, stored in `dbo.OfferPartner`).","operationId":"api_create_exchange_offer_api_offers_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferCreate"}}}},"responses":{"201":{"description":"Partner offer created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"422":{"description":"No partner given, or a partner of another application"}}}},"/api/offers/import":{"post":{"tags":["Offers"],"summary":"Import offers from a file","description":"Creates offers in `dbo.Offer` from a CSV or JSON file. Columns: Name and OfferCode (required), OfferType, OfferKind (Partner or Individual), Partners (PartnerCodes separated by ';'), Form (a form name), ValidFrom, ValidTo, Description, IsActive. Partners and forms are looked up by name in the application. Rules are not attached: attach approved rule versions in the rule designer. An OfferCode the application already has is skipped; each failed row is reported with its row number. Use dryRun=true to validate only.","operationId":"api_import_offers_api_offers_import_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"applicationId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Application GUID (or send X-App-Id)","title":"Applicationid"},"description":"Application GUID (or send X-App-Id)"},{"name":"dryRun","in":"query","required":false,"schema":{"type":"boolean","description":"Validate and report without saving","default":false,"title":"Dryrun"},"description":"Validate and report without saving"},{"name":"createdByUserId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Creator UserAccount GUID","title":"Createdbyuserid"},"description":"Creator UserAccount GUID"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_api_import_offers_api_offers_import_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportResult"}}}},"404":{"description":"Application not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/rule-usage":{"get":{"tags":["Offer Rules"],"summary":"Which offers use which rules","description":"One row per offer rule of the offers the caller may see: rule id, offer id and name, additional offer id, whether the offer is active.","operationId":"api_offer_rule_usage_api_offers_rule_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]},{"AppId":[]}]}},"/api/offers/{id}":{"get":{"tags":["Offers"],"summary":"Get offer by ID","description":"Retrieve full details for an offer by its UUID from `dbo.Offer`.","operationId":"api_get_exchange_offer_api_offers__id__get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Offer details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Offers"],"summary":"Update offer","description":"Update the configuration, dates, or default values of an existing offer in `dbo.Offer`.","operationId":"api_update_exchange_offer_api_offers__id__put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferUpdate"}}}},"responses":{"200":{"description":"Offer updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Offers"],"summary":"Deactivate offer","description":"Soft-deactivate an offer in `dbo.Offer` by setting `IsActive = 0`.","operationId":"api_delete_offer_api_offers__id__delete","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Offer deactivated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/reference-form":{"put":{"tags":["Offers"],"summary":"Update offer reference form","description":"Update the reference form definition (`FormDefinitionId` / `FormDefinitionVersionId`) pinned to an offer in `dbo.Offer`.","operationId":"api_update_offer_form_api_offers__id__reference_form_put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceFormUpdate"}}}},"responses":{"200":{"description":"Offer reference form updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/toggle-active":{"patch":{"tags":["Offers"],"summary":"Toggle offer active state","description":"Toggle the active/inactive state (`IsActive`) of an offer in `dbo.Offer`.","operationId":"api_toggle_offer_api_offers__id__toggle_active_patch","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Offer active state toggled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/additional-offers":{"get":{"tags":["Offers"],"summary":"List additional offers for offer","description":"Retrieve a paginated list of child additional offers attached to an exchange offer by its Offer ID from `dbo.AdditionalOffer`.","operationId":"api_list_offer_additional_offers_api_offers__id__additional_offers_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":10,"title":"Pagesize"},"description":"Items per page (max 200)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Page_AdditionalOfferOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Offers"],"summary":"Create additional offer for offer","description":"Attach a child additional offer directly to this exchange offer in `dbo.AdditionalOffer`.","operationId":"api_create_offer_additional_offer_api_offers__id__additional_offers_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdditionalOfferCreate"}}}},"responses":{"201":{"description":"Additional offer created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AdditionalOfferOut_"}}}},"404":{"description":"Parent exchange offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/rules":{"get":{"tags":["Offers"],"summary":"List rules for offer","description":"Retrieve all published business rules bound directly to an exchange offer by its Offer ID from `dbo.OfferRule` and `dbo.RuleDefinition`.","operationId":"api_offer_rules_api_offers__id__rules_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"List of associated business rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_RuleOut__"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/partners":{"get":{"tags":["Offers"],"summary":"List an offer's partners","operationId":"api_offer_partners_api_offers__id__partners_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_PartnerOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Offers"],"summary":"Set an offer's partners","description":"Replace the partners of a Partner offer (`dbo.OfferPartner`). An Individual offer cannot have partners.","operationId":"api_set_offer_partners_api_offers__id__partners_put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferPartnersUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/offer-rules":{"get":{"tags":["Offer Rules"],"summary":"List an offer's rules with its values","description":"The rules of the offer itself (`dbo.OfferRule`, no additional offer), each with the offer's own right-hand values.","operationId":"api_list_offer_rules_api_offers__id__offer_rules_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_OfferRuleOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Offer Rules"],"summary":"Add a rule to an offer","description":"Add an approved rule version to the offer; its values start from that version's values.","operationId":"api_add_offer_rule_api_offers__id__offer_rules_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferRuleIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferRuleOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/offer-rules/{offerRuleId}":{"patch":{"tags":["Offer Rules"],"summary":"Set an offer rule's values","operationId":"api_update_offer_rule_api_offers__id__offer_rules__offerRuleId__patch","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"offerRuleId","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offerruleid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferRuleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferRuleOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Offer Rules"],"summary":"Remove a rule from an offer","operationId":"api_remove_offer_rule_api_offers__id__offer_rules__offerRuleId__delete","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"offerRuleId","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offerruleid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/offers/{id}/tree":{"get":{"tags":["Hierarchy"],"summary":"Get offer hierarchy tree","description":"Retrieve the nested relationship tree for an offer: Offer details, parent Partner profile, child Additional Offers, and bound business Rules.","operationId":"api_get_offer_tree_api_offers__id__tree_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Offer hierarchy tree","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferHierarchyTreeResponse_"}}}},"404":{"description":"Offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/partners/{id}/rules":{"get":{"tags":["Partners"],"summary":"List rules for partner","description":"Retrieve all published business rules bound to an offer or partner profile from `dbo.OfferRule` and `dbo.RuleDefinition`.","operationId":"api_partner_rules_api_partners__id__rules_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"idType","in":"query","required":false,"schema":{"$ref":"#/components/schemas/IdType","description":"Target identifier type: partnerid or individual_id","default":"partnerid"},"description":"Target identifier type: partnerid or individual_id"}],"responses":{"200":{"description":"List of associated business rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_RuleOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/partners/{id}/offers":{"get":{"tags":["Partners"],"summary":"List offers for partner","description":"Retrieve all active exchange offers associated with a specific partner UUID from `dbo.Offer`.","operationId":"api_partner_offers_api_partners__id__offers_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"List of partner exchange offers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_OfferOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/additional-offers":{"get":{"tags":["Additional Offers"],"summary":"List additional offers","description":"Retrieve a paginated list of additional exchange offers from `dbo.AdditionalOffer`, optionally filtered by parent offer ID.","operationId":"api_list_additional_offers_api_additional_offers_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"offerId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional parent exchange offer UUID filter","title":"Offerid"},"description":"Optional parent exchange offer UUID filter"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":10,"title":"Pagesize"},"description":"Items per page (max 200)"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching additional offer name","title":"Name"},"description":"Optional filter matching additional offer name"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter matching additional offer code","title":"Code"},"description":"Optional filter matching additional offer code"},{"name":"additionalOfferType","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter for additional offer classification type","title":"Additionaloffertype"},"description":"Optional filter for additional offer classification type"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated additional offers","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated additional offers"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Page_AdditionalOfferOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Additional Offers"],"summary":"Create additional offer","description":"Create a child additional offer in `dbo.AdditionalOffer` linked to a parent exchange offer.","operationId":"api_create_additional_offer_api_additional_offers_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdditionalOfferCreate"}}}},"responses":{"201":{"description":"Additional offer created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AdditionalOfferOut_"}}}},"400":{"description":"OfferId is required"},"404":{"description":"Parent exchange offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/additional-offers/{id}":{"get":{"tags":["Additional Offers"],"summary":"Get additional offer by ID","description":"Retrieve a single additional offer record by its primary key UUID from `dbo.AdditionalOffer`.","operationId":"api_get_additional_offer_api_additional_offers__id__get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Additional offer details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AdditionalOfferOut_"}}}},"404":{"description":"Additional offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Additional Offers"],"summary":"Update additional offer","description":"Update fields, validity dates, or configuration of an additional offer by its UUID in `dbo.AdditionalOffer`.","operationId":"api_update_additional_offer_api_additional_offers__id__put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdditionalOfferUpdate"}}}},"responses":{"200":{"description":"Additional offer updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AdditionalOfferOut_"}}}},"404":{"description":"Additional offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Additional Offers"],"summary":"Deactivate additional offer","description":"Soft-deactivate an additional offer by setting `IsActive=False` in `dbo.AdditionalOffer`.","operationId":"api_deactivate_additional_offer_api_additional_offers__id__delete","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Additional offer deactivated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_str__Any__"}}}},"404":{"description":"Additional offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/additional-offers/{id}/toggle-active":{"patch":{"tags":["Additional Offers"],"summary":"Toggle additional offer active state","description":"Toggle active status (`IsActive`) for an additional offer in `dbo.AdditionalOffer`.","operationId":"api_toggle_additional_offer_api_additional_offers__id__toggle_active_patch","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Additional offer active state updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AdditionalOfferOut_"}}}},"404":{"description":"Additional offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/additional-offers/{id}/reference-form":{"put":{"tags":["Additional Offers"],"summary":"Update additional offer reference form","description":"Update the reference form definition pinned to an additional offer in `dbo.AdditionalOffer`.","operationId":"api_update_additional_offer_form_api_additional_offers__id__reference_form_put","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceFormUpdate"}}}},"responses":{"200":{"description":"Additional offer reference form updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AdditionalOfferOut_"}}}},"404":{"description":"Additional offer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/additional-offers/{id}/offer-rules":{"get":{"tags":["Offer Rules"],"summary":"List an additional offer's rules with its values","operationId":"api_list_additional_offer_rules_api_additional_offers__id__offer_rules_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_OfferRuleOut__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Offer Rules"],"summary":"Add a rule to an additional offer","operationId":"api_add_additional_offer_rule_api_additional_offers__id__offer_rules_post","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferRuleIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferRuleOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/additional-offers/{id}/offer-rules/{offerRuleId}":{"patch":{"tags":["Offer Rules"],"summary":"Set an additional offer rule's values","operationId":"api_update_additional_offer_rule_api_additional_offers__id__offer_rules__offerRuleId__patch","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"offerRuleId","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offerruleid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferRuleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_OfferRuleOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Offer Rules"],"summary":"Remove a rule from an additional offer","operationId":"api_remove_additional_offer_rule_api_additional_offers__id__offer_rules__offerRuleId__delete","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"offerRuleId","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offerruleid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-quality":{"get":{"tags":["Data Quality"],"summary":"Comprehensive data quality scan","description":"Run automated integrity scans across `dbo.Partner`, `dbo.Offer`, and `dbo.AdditionalOffer` detecting duplicates, orphan records, expired active flags, and inverted validity dates.","operationId":"api_data_quality_api_data_quality_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"maxIssues","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":5,"description":"Maximum number of issues to report per category","default":50,"title":"Maxissues"},"description":"Maximum number of issues to report per category"}],"responses":{"200":{"description":"Data quality diagnostic report with summary metrics and issue details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DataQualityReport_"}}}},"401":{"description":"Missing or invalid authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/dq-scan":{"get":{"tags":["Data Quality"],"summary":"Data quality integrity scan (Modern scan)","description":"Unified diagnostic scan matching `codemanager-ai-api` format. Validates duplicates, orphan relationships, expiration dates, and state consistency across partner and exchange offer records.","operationId":"api_dq_scan_api_dq_scan_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"maxIssues","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":5,"description":"Maximum number of issues to report per category","default":50,"title":"Maxissues"},"description":"Maximum number of issues to report per category"}],"responses":{"200":{"description":"Data quality analysis report and summary metrics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DataQualityReport_"}}}},"401":{"description":"Missing or invalid authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-quality/duplicates":{"get":{"tags":["Data Quality"],"summary":"Scan for duplicate codes","description":"Identify duplicate partner codes in `dbo.Partner` and duplicate offer codes in `dbo.Offer` within the same tenant application.","operationId":"api_scan_duplicates_api_data_quality_duplicates_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":5,"description":"Maximum number of records to return","default":50,"title":"Limit"},"description":"Maximum number of records to return"}],"responses":{"200":{"description":"List of duplicate codes and associated records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_str__Any__"}}}},"401":{"description":"Missing or invalid authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-quality/orphans":{"get":{"tags":["Data Quality"],"summary":"Scan for orphan child offers","description":"Detect child additional offers in `dbo.AdditionalOffer` whose parent `OfferId` does not exist in `dbo.Offer`.","operationId":"api_scan_orphans_api_data_quality_orphans_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":5,"description":"Maximum number of records to return","default":50,"title":"Limit"},"description":"Maximum number of records to return"}],"responses":{"200":{"description":"List of orphan additional offers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_str__Any__"}}}},"401":{"description":"Missing or invalid authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-quality/expired":{"get":{"tags":["Data Quality"],"summary":"Scan for expired active offers","description":"Detect active exchange offers in `dbo.Offer` whose `ValidToUtc` date has already passed but still have `IsActive=True`.","operationId":"api_scan_expired_api_data_quality_expired_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":5,"description":"Maximum number of records to return","default":50,"title":"Limit"},"description":"Maximum number of records to return"}],"responses":{"200":{"description":"List of expired offers remaining active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_str__Any__"}}}},"401":{"description":"Missing or invalid authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-quality/inconsistencies":{"get":{"tags":["Data Quality"],"summary":"Scan for relationship and date inconsistencies","description":"Detect state inconsistencies, including inverted validity date ranges (`ValidToUtc < ValidFromUtc`) and active child additional offers whose parent offer is deactivated.","operationId":"api_scan_inconsistencies_api_data_quality_inconsistencies_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":5,"description":"Maximum number of records to return","default":50,"title":"Limit"},"description":"Maximum number of records to return"}],"responses":{"200":{"description":"List of inconsistent records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_dict_str__Any__"}}}},"401":{"description":"Missing or invalid authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-quality/deactivate-expired":{"post":{"tags":["Data Quality"],"summary":"Auto-deactivate expired offers","description":"Automated remediation: sets `IsActive=False` on all exchange offers in `dbo.Offer` where `ValidToUtc` is past current UTC time and `IsActive` is True.","operationId":"api_deactivate_expired_offers_api_data_quality_deactivate_expired_post","responses":{"200":{"description":"Remediation summary and list of deactivated offer UUIDs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DataQualityFixResult_"}}}},"401":{"description":"Missing or invalid authorization header"}},"security":[{"APIKeyHeader":[]},{"AppId":[]}]}},"/api/export/partners":{"get":{"tags":["Transfer"],"summary":"Export partners dataset","description":"Bulk export partner records from `dbo.Partner` in either structured JSON or CSV format.","operationId":"export_partners_api_export_partners_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(json|csv)$","description":"Export file format: 'json' or 'csv'","default":"json","title":"Format"},"description":"Export file format: 'json' or 'csv'"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated partners","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated partners"},{"name":"applicationId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional application filter","title":"Applicationid"},"description":"Optional application filter"}],"responses":{"200":{"description":"Exported partners dataset","content":{"application/json":{"schema":{}},"text/csv":{}}},"401":{"description":"Missing or invalid internal authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/export/offers":{"get":{"tags":["Transfer"],"summary":"Export exchange offers dataset","description":"Bulk export exchange offers from `dbo.Offer` in either structured JSON or CSV format.","operationId":"export_offers_api_export_offers_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(json|csv)$","description":"Export file format: 'json' or 'csv'","default":"json","title":"Format"},"description":"Export file format: 'json' or 'csv'"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated offers","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated offers"},{"name":"partnerId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional partner filter","title":"Partnerid"},"description":"Optional partner filter"},{"name":"applicationId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional application filter","title":"Applicationid"},"description":"Optional application filter"}],"responses":{"200":{"description":"Exported exchange offers dataset","content":{"application/json":{"schema":{}},"text/csv":{}}},"401":{"description":"Missing or invalid internal authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/export/additional-offers":{"get":{"tags":["Transfer"],"summary":"Export additional offers dataset","description":"Bulk export child additional offers from `dbo.AdditionalOffer` in either structured JSON or CSV format.","operationId":"export_additional_offers_api_export_additional_offers_get","security":[{"APIKeyHeader":[]},{"AppId":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(json|csv)$","description":"Export file format: 'json' or 'csv'","default":"json","title":"Format"},"description":"Export file format: 'json' or 'csv'"},{"name":"includeInactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive/deactivated additional offers","default":false,"title":"Includeinactive"},"description":"Include inactive/deactivated additional offers"},{"name":"offerId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional parent offer filter","title":"Offerid"},"description":"Optional parent offer filter"},{"name":"applicationId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Optional application filter","title":"Applicationid"},"description":"Optional application filter"}],"responses":{"200":{"description":"Exported additional offers dataset","content":{"application/json":{"schema":{}},"text/csv":{}}},"401":{"description":"Missing or invalid internal authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/search":{"get":{"tags":["Utilities"],"summary":"Global universal search across partners, offers, and add-ons","description":"Fast substring search matching names, codes, categories, and descriptions across `dbo.Partner`, `dbo.Offer`, and `dbo.AdditionalOffer`.","operationId":"api_global_search_api_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Search keyword matching name, code, category, or description","title":"Q"},"description":"Search keyword matching name, code, category, or description"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return (max 100)","default":20,"title":"Limit"},"description":"Maximum results to return (max 100)"}],"responses":{"200":{"description":"Matching entities across partners, offers, and additional offers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_SearchResultItem__"}}}},"401":{"description":"Missing or invalid internal authorization header"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/summary":{"get":{"tags":["Utilities"],"summary":"Executive operational metrics and entity count summary","description":"Returns real-time entity count snapshots across partners, active offers, add-ons, mapped rules, and data quality status.","operationId":"api_dashboard_summary_api_summary_get","responses":{"200":{"description":"Real-time entity counts and health metrics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DashboardSummaryResponse_"}}}},"401":{"description":"Missing or invalid internal authorization header"}},"security":[{"APIKeyHeader":[]}]}},"/api/stats":{"get":{"tags":["Utilities"],"summary":"Application operational runtime statistics","description":"Returns service name, current version, process uptime in seconds, and health status.","operationId":"api_stats_api_stats_get","responses":{"200":{"description":"Runtime operational metrics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppStatsResponse"}}}},"401":{"description":"Missing or invalid internal authorization header"}},"security":[{"APIKeyHeader":[]}]}},"/health":{"get":{"tags":["Health"],"summary":"Service health check","description":"Check service health, running process status, active version, uptime, and database connectivity.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/db-ping":{"get":{"tags":["Health"],"summary":"Database connectivity diagnostics","description":"Ping SQL Server database and return round-trip latency.","operationId":"db_ping_db_ping_get","responses":{"200":{"description":"Database is reachable and healthy","content":{"application/json":{"schema":{}}}},"503":{"description":"Database connection error"}}}}},"components":{"schemas":{"AdditionalOfferCreate":{"properties":{"Name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"AdditionalOfferCode":{"type":"string","maxLength":100,"minLength":1,"title":"Additionaloffercode"},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"OfferId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Offerid","description":"Parent exchange offer UUID (optional if specified in path)"},"AdditionalOfferType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Additionaloffertype"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"PartnerId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Partnerid"},"OrderNumber":{"type":"integer","title":"Ordernumber","default":0},"IsActive":{"type":"boolean","title":"Isactive","default":true},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"}},"type":"object","required":["Name","AdditionalOfferCode","ApplicationId"],"title":"AdditionalOfferCreate","example":{"AdditionalOfferCode":"TELEHEALTH_ADDON","AdditionalOfferType":"Addon","ApplicationId":"11111111-1111-1111-1111-111111111111","DefaultValuesJson":{"copayWaived":true},"Description":"24/7 on-demand virtual specialist consultations.","IsActive":true,"Name":"Priority Telehealth Consultations Add-on","OrderNumber":1,"PartnerId":"33333333-3333-3333-3333-333333333333","ValidFromUtc":"2026-01-01T00:00:00Z","ValidToUtc":"2026-12-31T23:59:59Z"}},"AdditionalOfferOut":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"AdditionalOfferType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additionaloffertype"},"Name":{"type":"string","title":"Name"},"AdditionalOfferCode":{"type":"string","title":"Additionaloffercode"},"OfferId":{"type":"string","format":"uuid","title":"Offerid"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"OrderNumber":{"type":"integer","title":"Ordernumber"},"IsActive":{"type":"boolean","title":"Isactive"},"CreatedAtUtc":{"type":"string","format":"date-time","title":"Createdatutc"},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"},"UpdatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","required":["Id","Name","AdditionalOfferCode","OfferId","ApplicationId","OrderNumber","IsActive","CreatedAtUtc"],"title":"AdditionalOfferOut"},"AdditionalOfferUpdate":{"properties":{"Name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"},"AdditionalOfferCode":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Additionaloffercode"},"AdditionalOfferType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Additionaloffertype"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"PartnerId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Partnerid"},"ApplicationId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Applicationid"},"OrderNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ordernumber"},"IsActive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","title":"AdditionalOfferUpdate","example":{"Description":"Updated telehealth terms and expanded physician network.","IsActive":true,"Name":"Priority Telehealth Consultations Add-on (Updated)","OrderNumber":2,"UpdatedNotes":"Updated provider list."}},"AdditionalOfferWithRules":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"AdditionalOfferType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additionaloffertype"},"Name":{"type":"string","title":"Name"},"AdditionalOfferCode":{"type":"string","title":"Additionaloffercode"},"OfferId":{"type":"string","format":"uuid","title":"Offerid"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"OrderNumber":{"type":"integer","title":"Ordernumber"},"IsActive":{"type":"boolean","title":"Isactive"},"CreatedAtUtc":{"type":"string","format":"date-time","title":"Createdatutc"},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"},"UpdatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"},"rules":{"items":{"$ref":"#/components/schemas/OfferRuleOut"},"type":"array","title":"Rules"}},"type":"object","required":["Id","Name","AdditionalOfferCode","OfferId","ApplicationId","OrderNumber","IsActive","CreatedAtUtc"],"title":"AdditionalOfferWithRules"},"ApiResponse_AdditionalOfferOut_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/AdditionalOfferOut"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[AdditionalOfferOut]"},"ApiResponse_DashboardSummaryResponse_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/DashboardSummaryResponse"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[DashboardSummaryResponse]"},"ApiResponse_DataQualityFixResult_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/DataQualityFixResult"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[DataQualityFixResult]"},"ApiResponse_DataQualityReport_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/DataQualityReport"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[DataQualityReport]"},"ApiResponse_OfferHierarchyTreeResponse_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/OfferHierarchyTreeResponse"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[OfferHierarchyTreeResponse]"},"ApiResponse_OfferOut_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/OfferOut"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[OfferOut]"},"ApiResponse_OfferRuleOut_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/OfferRuleOut"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[OfferRuleOut]"},"ApiResponse_Page_AdditionalOfferOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/Page_AdditionalOfferOut_"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[Page[AdditionalOfferOut]]"},"ApiResponse_Page_OfferOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/Page_OfferOut_"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[Page[OfferOut]]"},"ApiResponse_Page_PartnerOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/Page_PartnerOut_"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[Page[PartnerOut]]"},"ApiResponse_PartnerHierarchyTreeResponse_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/PartnerHierarchyTreeResponse"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[PartnerHierarchyTreeResponse]"},"ApiResponse_PartnerOut_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/PartnerOut"},{"type":"null"}]}},"type":"object","required":["success","message"],"title":"ApiResponse[PartnerOut]"},"ApiResponse_dict_":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[dict]"},"ApiResponse_dict_str__Any__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[dict[str, Any]]"},"ApiResponse_list_OfferOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/OfferOut"},"type":"array"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[list[OfferOut]]"},"ApiResponse_list_OfferRuleOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/OfferRuleOut"},"type":"array"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[list[OfferRuleOut]]"},"ApiResponse_list_PartnerOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/PartnerOut"},"type":"array"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[list[PartnerOut]]"},"ApiResponse_list_RuleOut__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/RuleOut"},"type":"array"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[list[RuleOut]]"},"ApiResponse_list_SearchResultItem__":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchResultItem"},"type":"array"},{"type":"null"}],"title":"Data"}},"type":"object","required":["success","message"],"title":"ApiResponse[list[SearchResultItem]]"},"AppStatsResponse":{"properties":{"app":{"type":"string","title":"App"},"version":{"type":"string","title":"Version"},"uptime_sec":{"type":"number","title":"Uptime Sec"},"status":{"type":"string","title":"Status"}},"type":"object","required":["app","version","uptime_sec","status"],"title":"AppStatsResponse"},"Body_api_import_offers_api_offers_import_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Offers as CSV or JSON"}},"type":"object","required":["file"],"title":"Body_api_import_offers_api_offers_import_post"},"Body_api_import_partners_api_partners_import_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Partners as CSV or JSON"}},"type":"object","required":["file"],"title":"Body_api_import_partners_api_partners_import_post"},"DashboardEntityCount":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entity records"},"active":{"type":"integer","title":"Active","description":"Active entity records"},"inactive":{"type":"integer","title":"Inactive","description":"Deactivated entity records"}},"type":"object","required":["total","active","inactive"],"title":"DashboardEntityCount"},"DashboardOfferCount":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entity records"},"active":{"type":"integer","title":"Active","description":"Active entity records"},"inactive":{"type":"integer","title":"Inactive","description":"Deactivated entity records"},"partner_offers":{"type":"integer","title":"Partner Offers","description":"Offers associated with partners"},"individual_offers":{"type":"integer","title":"Individual Offers","description":"Direct company individual offers"},"expired_active":{"type":"integer","title":"Expired Active","description":"Active offers whose validity period is expired"}},"type":"object","required":["total","active","inactive","partner_offers","individual_offers","expired_active"],"title":"DashboardOfferCount"},"DashboardRuleCount":{"properties":{"total_mapped_active":{"type":"integer","title":"Total Mapped Active","description":"Total active business rules mapped to offers"}},"type":"object","required":["total_mapped_active"],"title":"DashboardRuleCount"},"DashboardSummaryResponse":{"properties":{"partners":{"$ref":"#/components/schemas/DashboardEntityCount"},"offers":{"$ref":"#/components/schemas/DashboardOfferCount"},"additional_offers":{"$ref":"#/components/schemas/DashboardEntityCount"},"rules":{"$ref":"#/components/schemas/DashboardRuleCount"},"timestamp_utc":{"type":"string","title":"Timestamp Utc","description":"ISO 8601 UTC timestamp of the metric snapshot"}},"type":"object","required":["partners","offers","additional_offers","rules","timestamp_utc"],"title":"DashboardSummaryResponse"},"DataQualityFixResult":{"properties":{"remediated_count":{"type":"integer","title":"Remediated Count","description":"Number of records modified during remediation"},"offer_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Offer Ids","description":"List of offer UUIDs that were deactivated"},"message":{"type":"string","title":"Message","description":"Remediation execution outcome summary"},"timestamp_utc":{"type":"string","title":"Timestamp Utc","description":"ISO 8601 UTC timestamp of the remediation run"}},"type":"object","required":["remediated_count","message","timestamp_utc"],"title":"DataQualityFixResult","example":{"message":"Successfully deactivated 2 expired offer(s).","offer_ids":["55555555-5555-5555-5555-555555555555","66666666-6666-6666-6666-666666666666"],"remediated_count":2,"timestamp_utc":"2026-10-19T12:00:00Z"}},"DataQualityIssue":{"properties":{"category":{"type":"string","title":"Category","description":"Category of the detected issue, e.g. Duplicate Code, Orphan Reference, Expired Status, Invalid Date Range, State Inconsistency"},"severity":{"type":"string","title":"Severity","description":"Severity level: error, warning, or info"},"entity":{"type":"string","title":"Entity","description":"Target entity table name, e.g. Partner, Offer, AdditionalOffer"},"record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Id","description":"Primary key UUID of the affected entity if available"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier","description":"Code or name identifying the affected record"},"description":{"type":"string","title":"Description","description":"Detailed explanation of the integrity violation"},"suggested_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Action","description":"Recommended remediation step"}},"type":"object","required":["category","severity","entity","description"],"title":"DataQualityIssue"},"DataQualityReport":{"properties":{"timestamp_utc":{"type":"string","title":"Timestamp Utc","description":"ISO 8601 UTC timestamp when the diagnostic scan was completed"},"total_issues":{"type":"integer","title":"Total Issues","description":"Total issues found across all categories"},"partners_scanned":{"type":"integer","title":"Partners Scanned","description":"Total partner records evaluated in dbo.Partner","default":0},"offers_scanned":{"type":"integer","title":"Offers Scanned","description":"Total offer records evaluated in dbo.Offer","default":0},"additional_offers_scanned":{"type":"integer","title":"Additional Offers Scanned","description":"Total additional offer records evaluated in dbo.AdditionalOffer","default":0},"summary":{"$ref":"#/components/schemas/DataQualitySummary","description":"Categorized count breakdown of detected issues"},"duplicates":{"items":{"type":"object"},"type":"array","title":"Duplicates","description":"Duplicate partner code and offer code details"},"orphans":{"items":{"type":"object"},"type":"array","title":"Orphans","description":"Orphan additional offer records lacking parent offers"},"expired":{"items":{"type":"object"},"type":"array","title":"Expired","description":"Active offers past their ValidToUtc expiration date"},"inconsistencies":{"items":{"type":"object"},"type":"array","title":"Inconsistencies","description":"Cross-table state inconsistencies and inverted date ranges"},"issues":{"items":{"$ref":"#/components/schemas/DataQualityIssue"},"type":"array","title":"Issues","description":"Unified flat list of all detected issues for tabular view"}},"type":"object","required":["timestamp_utc","total_issues","summary"],"title":"DataQualityReport","example":{"additional_offers_scanned":820,"duplicates":[{"applicationId":"11111111-1111-1111-1111-111111111111","code":"PRT_CARE","count":2,"entity":"Partner"}],"expired":[{"id":"55555555-5555-5555-5555-555555555555","isActive":true,"name":"Summer Wellness 2025","offerCode":"WELL_2025","validToUtc":"2025-08-31T23:59:59Z"}],"inconsistencies":[{"childIsActive":true,"entity":"AdditionalOffer","id":"77777777-7777-7777-7777-777777777777","name":"Dental Rider","parentIsActive":false,"parentOfferName":"Legacy HMO"}],"issues":[{"category":"Duplicate Code","description":"Partner code 'PRT_CARE' is used by 2 records in application 11111111-1111-1111-1111-111111111111.","entity":"Partner","identifier":"PRT_CARE","severity":"error","suggested_action":"Ensure partner codes are unique per tenant application."}],"offers_scanned":450,"orphans":[],"partners_scanned":128,"summary":{"duplicate_count":1,"expired_count":1,"inconsistency_count":1,"orphan_count":0,"total_issues":3},"timestamp_utc":"2026-10-19T12:00:00Z","total_issues":3}},"DataQualitySummary":{"properties":{"duplicate_count":{"type":"integer","title":"Duplicate Count","description":"Total duplicate code conflicts detected","default":0},"orphan_count":{"type":"integer","title":"Orphan Count","description":"Total orphan child records referencing non-existent parents","default":0},"expired_count":{"type":"integer","title":"Expired Count","description":"Total expired offers that remain flagged active","default":0},"inconsistency_count":{"type":"integer","title":"Inconsistency Count","description":"Total state or date range inconsistencies","default":0},"total_issues":{"type":"integer","title":"Total Issues","description":"Grand total of all integrity issues identified","default":0}},"type":"object","title":"DataQualitySummary"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"version":{"type":"string","title":"Version"},"uptime_sec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Sec"},"database":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database"},"latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latency Ms"}},"type":"object","required":["status","service","version"],"title":"HealthResponse"},"HierarchyOfferNode":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"Name":{"type":"string","title":"Name"},"OfferCode":{"type":"string","title":"Offercode"},"OfferType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offertype"},"OfferKind":{"type":"string","title":"Offerkind","default":"Partner"},"PartnerIds":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Partnerids"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"IsActive":{"type":"boolean","title":"Isactive"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"additionalOffers":{"items":{"$ref":"#/components/schemas/AdditionalOfferOut"},"type":"array","title":"Additionaloffers"},"rules":{"items":{"$ref":"#/components/schemas/RuleOut"},"type":"array","title":"Rules"}},"type":"object","required":["Id","Name","OfferCode","IsActive"],"title":"HierarchyOfferNode"},"IdType":{"type":"string","enum":["partnerid","individual_id"],"title":"IdType"},"ImportResult":{"properties":{"ok":{"type":"boolean","title":"Ok"},"dryRun":{"type":"boolean","title":"Dryrun"},"entity":{"type":"string","title":"Entity"},"summary":{"$ref":"#/components/schemas/ImportSummary"},"errors":{"items":{"$ref":"#/components/schemas/ImportRowError"},"type":"array","title":"Errors","default":[]}},"type":"object","required":["ok","dryRun","entity","summary"],"title":"ImportResult"},"ImportRowError":{"properties":{"row":{"type":"integer","title":"Row"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["row","reason"],"title":"ImportRowError"},"ImportSummary":{"properties":{"created":{"type":"integer","title":"Created","default":0},"skipped":{"type":"integer","title":"Skipped","default":0},"errors":{"type":"integer","title":"Errors","default":0}},"type":"object","title":"ImportSummary"},"OfferCreate":{"properties":{"Name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"OfferCode":{"type":"string","maxLength":100,"minLength":1,"title":"Offercode"},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"OfferType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Offertype"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"OfferSchemaJson":{"anyOf":[{},{"type":"null"}],"title":"Offerschemajson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"OfferKind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offerkind","description":"Individual or Partner (default: Partner when partners are given)"},"PartnerIds":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Partnerids","description":"The offer's partners (a Partner offer)"},"PartnerId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Partnerid","description":"Legacy: a single partner"},"IsActive":{"type":"boolean","title":"Isactive","default":true},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"}},"type":"object","required":["Name","OfferCode","ApplicationId"],"title":"OfferCreate","example":{"ApplicationId":"11111111-1111-1111-1111-111111111111","DefaultValuesJson":{"discountPct":15,"planTier":"Gold"},"Description":"Comprehensive enterprise health exchange promotional package.","FormDefinitionId":"44444444-4444-4444-4444-444444444444","IsActive":true,"Name":"Annual Comprehensive Care Exchange Offer","OfferCode":"CARE_EXCHANGE_2026","OfferKind":"Partner","OfferType":"Annual","PartnerIds":["33333333-3333-3333-3333-333333333333"],"ValidFromUtc":"2026-01-01T00:00:00Z","ValidToUtc":"2026-12-31T23:59:59Z"}},"OfferHierarchyTreeResponse":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"Name":{"type":"string","title":"Name"},"OfferCode":{"type":"string","title":"Offercode"},"OfferType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offertype"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"IsActive":{"type":"boolean","title":"Isactive"},"PartnerId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Partnerid"},"OfferKind":{"type":"string","title":"Offerkind","default":"Partner"},"PartnerIds":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Partnerids"},"additionalOffers":{"items":{"$ref":"#/components/schemas/AdditionalOfferWithRules"},"type":"array","title":"Additionaloffers"},"rules":{"items":{"$ref":"#/components/schemas/RuleOut"},"type":"array","title":"Rules"},"partners":{"items":{"$ref":"#/components/schemas/PartnerOut"},"type":"array","title":"Partners"},"partner":{"anyOf":[{"$ref":"#/components/schemas/PartnerOut"},{"type":"null"}]}},"type":"object","required":["Id","Name","OfferCode","IsActive"],"title":"OfferHierarchyTreeResponse"},"OfferOut":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"OfferType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offertype"},"Name":{"type":"string","title":"Name"},"OfferCode":{"type":"string","title":"Offercode"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"OfferSchemaJson":{"anyOf":[{},{"type":"null"}],"title":"Offerschemajson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"OfferKind":{"type":"string","title":"Offerkind","description":"Individual (no partners) or Partner","default":"Partner"},"PartnerIds":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Partnerids","description":"The offer's partners (dbo.OfferPartner)"},"Partners":{"items":{"$ref":"#/components/schemas/OfferPartnerRef"},"type":"array","title":"Partners"},"PartnerId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Partnerid","description":"Legacy: the first partner"},"RuleCount":{"type":"integer","title":"Rulecount","description":"The offer's own rules (dbo.OfferRule)","default":0},"AdditionalOfferCount":{"type":"integer","title":"Additionaloffercount","description":"Active additional offers","default":0},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"IsActive":{"type":"boolean","title":"Isactive"},"CreatedAtUtc":{"type":"string","format":"date-time","title":"Createdatutc"},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"},"UpdatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","required":["Id","Name","OfferCode","ApplicationId","IsActive","CreatedAtUtc"],"title":"OfferOut"},"OfferPartnerRef":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"Name":{"type":"string","title":"Name"},"PartnerCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partnercode"}},"type":"object","required":["Id","Name"],"title":"OfferPartnerRef"},"OfferPartnersUpdate":{"properties":{"PartnerIds":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Partnerids","description":"All partners of the offer (replaces the current ones)"}},"type":"object","title":"OfferPartnersUpdate"},"OfferRuleIn":{"properties":{"RuleDefinitionId":{"type":"string","format":"uuid","title":"Ruledefinitionid"},"RuleDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Ruledefinitionversionid","description":"Approved version to use (default: the published one)"},"OrderNumber":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Ordernumber"},"RuleRole":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Rulerole"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"}},"type":"object","required":["RuleDefinitionId"],"title":"OfferRuleIn"},"OfferRuleOut":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"OfferRuleId":{"type":"string","format":"uuid","title":"Offerruleid"},"OfferId":{"type":"string","format":"uuid","title":"Offerid"},"AdditionalOfferId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Additionalofferid"},"RuleDefinitionId":{"type":"string","format":"uuid","title":"Ruledefinitionid"},"RuleDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Ruledefinitionversionid"},"RuleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rulename"},"RuleType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ruletype"},"Version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version"},"LifecycleStatus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lifecyclestatus"},"RawRule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rawrule"},"ScriptBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scriptbody"},"PricingScriptBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricingscriptbody"},"OrderNumber":{"type":"integer","title":"Ordernumber"},"RuleRole":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rulerole"},"IsEnabled":{"type":"boolean","title":"Isenabled"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"CreatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createdatutc"},"UpdatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","required":["Id","OfferRuleId","OfferId","RuleDefinitionId","OrderNumber","IsEnabled"],"title":"OfferRuleOut"},"OfferRuleUpdate":{"properties":{"ScriptBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scriptbody"},"PricingScriptBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricingscriptbody"},"RuleDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Ruledefinitionversionid","description":"Move to another approved version (restarts the values unless given)"},"OrderNumber":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Ordernumber"},"RuleRole":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Rulerole"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"IsEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isenabled"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","title":"OfferRuleUpdate","description":"The offer's own right-hand values for the rule, and its place in the offer."},"OfferUpdate":{"properties":{"Name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"},"OfferCode":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Offercode"},"OfferType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Offertype"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"FormDefinitionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"},"DefaultValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Defaultvaluesjson"},"UpdatedValuesJson":{"anyOf":[{},{"type":"null"}],"title":"Updatedvaluesjson"},"OfferSchemaJson":{"anyOf":[{},{"type":"null"}],"title":"Offerschemajson"},"ValidFromUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validfromutc"},"ValidToUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Validtoutc"},"OfferKind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offerkind","description":"Individual or Partner; Individual removes the partners"},"PartnerIds":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Partnerids","description":"All partners of the offer (replaces the current ones)"},"PartnerId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Partnerid","description":"Legacy: a single partner"},"ApplicationId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Applicationid"},"IsActive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","title":"OfferUpdate","example":{"Description":"Extended validity period with revised promotional terms.","IsActive":true,"Name":"Annual Comprehensive Care Exchange Offer (Revised)","OfferType":"Annual","UpdatedNotes":"Extended promotional period through mid-2027.","ValidFromUtc":"2026-01-01T00:00:00Z","ValidToUtc":"2027-06-30T23:59:59Z"}},"Page_AdditionalOfferOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdditionalOfferOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"pageSize":{"type":"integer","title":"Pagesize"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["items","total","page","pageSize","pages"],"title":"Page[AdditionalOfferOut]"},"Page_OfferOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OfferOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"pageSize":{"type":"integer","title":"Pagesize"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["items","total","page","pageSize","pages"],"title":"Page[OfferOut]"},"Page_PartnerOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PartnerOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"pageSize":{"type":"integer","title":"Pagesize"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["items","total","page","pageSize","pages"],"title":"Page[PartnerOut]"},"PartnerCreate":{"properties":{"Name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"PartnerCode":{"type":"string","maxLength":100,"minLength":1,"title":"Partnercode"},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"ClientId":{"type":"string","format":"uuid","title":"Clientid"},"PartnerType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Partnertype"},"Email":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Email"},"PhoneNumber":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Phonenumber"},"Address":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Address"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"IsActive":{"type":"boolean","title":"Isactive","default":true},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"}},"type":"object","required":["Name","PartnerCode","ApplicationId","ClientId"],"title":"PartnerCreate","example":{"Address":"100 Innovation Way, Suite 400, Boston, MA 02110","ApplicationId":"11111111-1111-1111-1111-111111111111","ClientId":"22222222-2222-2222-2222-222222222222","Description":"Strategic healthcare and diagnostics partner.","Email":"contact@apexhealth.com","IsActive":true,"Name":"Apex Healthcare Solutions","PartnerCode":"APEX_HEALTH","PartnerType":"Vendor","PhoneNumber":"+1-800-555-0199"}},"PartnerHierarchyTreeResponse":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"Name":{"type":"string","title":"Name"},"PartnerCode":{"type":"string","title":"Partnercode"},"PartnerType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partnertype"},"Email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"PhoneNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phonenumber"},"IsActive":{"type":"boolean","title":"Isactive"},"offers":{"items":{"$ref":"#/components/schemas/HierarchyOfferNode"},"type":"array","title":"Offers"}},"type":"object","required":["Id","Name","PartnerCode","IsActive"],"title":"PartnerHierarchyTreeResponse"},"PartnerOut":{"properties":{"Id":{"type":"string","format":"uuid","title":"Id"},"Name":{"type":"string","title":"Name"},"PartnerType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partnertype"},"PartnerCode":{"type":"string","title":"Partnercode"},"Email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"PhoneNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phonenumber"},"Address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"ApplicationId":{"type":"string","format":"uuid","title":"Applicationid"},"ClientId":{"type":"string","format":"uuid","title":"Clientid"},"IsActive":{"type":"boolean","title":"Isactive"},"CreatedAtUtc":{"type":"string","format":"date-time","title":"Createdatutc"},"CreatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Createdbyuserid"},"UpdatedAtUtc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updatedatutc"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","required":["Id","Name","PartnerCode","ApplicationId","ClientId","IsActive","CreatedAtUtc"],"title":"PartnerOut"},"PartnerUpdate":{"properties":{"Name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"},"PartnerCode":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Partnercode"},"PartnerType":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Partnertype"},"Email":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Email"},"PhoneNumber":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Phonenumber"},"Address":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Address"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"ApplicationId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Applicationid"},"ClientId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Clientid"},"IsActive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Isactive"},"UpdatedByUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Updatedbyuserid"},"UpdatedNotes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatednotes"}},"type":"object","title":"PartnerUpdate","example":{"Address":"100 Innovation Way, Suite 500, Boston, MA 02110","Description":"Updated partner description and headquarters location.","Email":"support@apexhealth.com","IsActive":true,"Name":"Apex Healthcare Solutions (Updated)","PartnerType":"Strategic Partner","PhoneNumber":"+1-800-555-0199","UpdatedNotes":"Upgraded tier to Strategic Partner."}},"ReferenceFormUpdate":{"properties":{"FormDefinitionId":{"type":"string","format":"uuid","title":"Formdefinitionid"},"FormDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Formdefinitionversionid"}},"type":"object","required":["FormDefinitionId"],"title":"ReferenceFormUpdate","example":{"FormDefinitionId":"44444444-4444-4444-4444-444444444444","FormDefinitionVersionId":"55555555-5555-5555-5555-555555555555"}},"RuleOut":{"properties":{"OfferId":{"type":"string","format":"uuid","title":"Offerid"},"AdditionalOfferId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Additionalofferid"},"OfferRuleId":{"type":"string","format":"uuid","title":"Offerruleid"},"RuleDefinitionId":{"type":"string","format":"uuid","title":"Ruledefinitionid"},"RuleDefinitionVersionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Ruledefinitionversionid"},"RuleName":{"type":"string","title":"Rulename"},"RuleType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ruletype"},"RuleRole":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rulerole"},"OrderNumber":{"type":"integer","title":"Ordernumber"},"Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"RawRule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rawrule"},"RawRuleAi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rawruleai"},"ScriptBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scriptbody"},"PricingScriptBody":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricingscriptbody"},"Version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version"},"LifecycleStatus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lifecyclestatus"}},"type":"object","required":["OfferId","OfferRuleId","RuleDefinitionId","RuleName","OrderNumber"],"title":"RuleOut"},"SearchResultItem":{"properties":{"type":{"type":"string","title":"Type","description":"Entity type: Partner, Offer, or AdditionalOffer"},"id":{"type":"string","title":"Id","description":"Primary key UUID string"},"code":{"type":"string","title":"Code","description":"Entity unique code or key"},"name":{"type":"string","title":"Name","description":"Entity name or title"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Type or classification category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Summary or description"},"isActive":{"type":"boolean","title":"Isactive","description":"Active lifecycle status"},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parentid","description":"Parent UUID if applicable"}},"type":"object","required":["type","id","code","name","isActive"],"title":"SearchResultItem"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"Enter internal service auth secret (e.g. wf_internal_7uFq3sV8k2Qp1mN6yX0dJr9vL5aZcT4hG8nP2sW5)","in":"header","name":"X-Internal-Auth"},"AppId":{"type":"apiKey","description":"Application.Id GUID context for application-scoped data.","in":"header","name":"X-App-Id"}}},"tags":[{"name":"Partners","description":"Lifecycle management of partner directory profiles, classification types, contact details, associated exchange offers, and bound business rules in `dbo.Partner`."},{"name":"Offers","description":"Partner exchange offers, direct individual company offers, active status toggling, reference form bindings, and rule associations in `dbo.Offer`."},{"name":"Additional Offers","description":"Child additional exchange offers, add-on terms, ordering, and nested reference form definitions in `dbo.AdditionalOffer`."},{"name":"Hierarchy","description":"Complete nested relationship trees and cascading parent-child views (Partner -> Offers -> Additional Offers & Rules)."},{"name":"Data Quality","description":"Automated data integrity diagnostics and remediation suite: duplicate code detection, orphan child offers, expired active flags, date range anomalies, and automated deactivation."},{"name":"Transfer","description":"Bulk data export and dataset synchronization for partner profiles, exchange offers, and additional offers across JSON and CSV formats."},{"name":"Utilities","description":"Global universal search across all entities, operational dashboard KPI summaries, and runtime diagnostics."},{"name":"Health","description":"Service readiness, connectivity ping tests, and environment health checks."}]}