Conditional Requirements
The rules below are generated from the same validation registry the Partner API enforces at request time — not hand-maintained prose. See the create endpoint (POST /api/v1/partner/cases/create/) in the API Reference for the served version of these same rules.
Every case_type → product combination below is rendered as its own section, open or closed — nothing here requires JavaScript. The picker just filters down to the pair you’re working with.
Requirements by product
Section titled “Requirements by product”Policy Existence
commercial_auto_policy_existence
Required
defendant_business_nameis_defendant_transportation_companyusdot_number
Forbidden
None
Format
- Field 'usdot_number' must be a valid USDOT number (digits only, not all zeros) when 'base_product' is 'commercial_auto_policy_existence'. Red Folder Research is only able to process Commercial Policy Existence requests for transportation companies with an active USDOT number.
personal_auto_policy_existence
Required
None
Forbidden
is_defendant_transportation_company
personal_homeowners_policy_existence
Required
insured_property_informationis_defendant_property_owner_and_occupant
Forbidden
is_defendant_transportation_company
Policy Limit
commercial_auto_policy_limits
Required
defendant_business_name
Forbidden
None
commercial_general_liability_policy_limits
Required
defendant_business_name
Forbidden
None
international_commercial_policy_limits
Required
defendant_business_name
Forbidden
None
commercial_other_policy_limits
Required
defendant_business_name
Forbidden
None
personal_auto_policy_limits
Required
None
Forbidden
commercial_driver_information
personal_homeowner_or_renters_policy_limits
Required
None
Forbidden
commercial_driver_information
international_personal_policy_limits
Required
None
Forbidden
commercial_driver_information
Trigger rules
Section titled “Trigger rules”Cross-field rules that aren’t scoped to a single product — each fires off a combination of fields rather than the product choice itself.
| Condition | Effect |
|---|---|
list_contains_when (files_to_upload) | Field 'files_to_upload' must contain 'incident_report' in case field 'is_incident_report_provided' is True. |
required_when (excluded_insurance_policy_information) | Field 'excluded_insurance_policy_information' must be defined and non-empty when 'should_exclude_other_insurance_from_search' is True. |
forbidden_when (other_search_reason) | Field 'other_search_reason' must not be defined when the field 'search_reason' does not contain the 'other_reason' option. |
at_least_one_of (policy_number, claim_number) | Fields 'policy_number' and 'claim_number' can not both be empty.You must define one (or both) of the fields. |
homogeneous_list (base_product) | Field 'base_product' must contain commercial or personal options, not both. |
presence_required_when (policyholder_name) | Fields 'policyholder_name' and 'policyholder_relationship' must be definedin case field 'are_policyholder_and_defendant_the_same' is False. |
presence_required_when (policyholder_relationship) | Fields 'policyholder_name' and 'policyholder_relationship' must be definedin case field 'are_policyholder_and_defendant_the_same' is False. |
search_forbidden_when (insurance_company) | Field 'insurance_company' matches unaccepted carrier 'American National'. Red Folder Research does not accept Policy Limit cases for this carrier. |
search_forbidden_when (insurance_company) | Field 'insurance_company' matches unaccepted carrier 'Federated Insurance'. Red Folder Research does not accept Policy Limit cases for this carrier. |
search_forbidden_when (insurance_company) | Field 'insurance_company' matches unaccepted carrier 'Go Insurance'. Red Folder Research does not accept Policy Limit cases for this carrier. |
search_forbidden_when (insurance_company) | Field 'insurance_company' matches unaccepted carrier 'Security National Insurance'. Red Folder Research does not accept Policy Limit cases for this carrier. |
search_forbidden_when (insurance_company) | Field 'insurance_company' matches unaccepted carrier 'USAA'. Red Folder Research does not accept Policy Limit cases for this carrier. |
search_forbidden_when (insurance_company) | Field 'insurance_company' matches unaccepted carrier 'Wawanesa'. Red Folder Research does not accept Policy Limit cases for this carrier. |
Nested object minimums
Section titled “Nested object minimums”If you send any member of one of these nested objects, the members below become required on that object.
| Object | Required members |
|---|---|
personal_information | address, first_name, last_name |
address_information | address, city, postal_or_zip_code, state_or_province |
Additional server-side checks
Section titled “Additional server-side checks”Some checks are applied server-side after request validation because they depend on your organization's configuration. Errors from these checks are returned with the same HTTP 400 JSON shape as conditional-requirement errors but do not appear in the auto-generated matrix above.
- AAA Southern California requires Black Card program enrollment. Raised during PLS submission when
insurance_company == "aaa_or_interinsurance_southern_california"for non-Black-Card organizations. Contact support to enroll or choose a different insurance company. insurance_company_namedeprecation. Logged as a warning, not an error; behavior unchanged.- PE
date_of_lossmust be within the last 365 days. Enforced only on Policy Existence — adate_of_lossolder than 365 days is rejected with a 400. Policy Limit has no such time-window restriction ondate_of_loss. crash_statemust be a two-letter uppercase US state code, or empty. Enforced via server-side regex (^[A-Z]{2}$|^$) on both Policy Existence and Policy Limit; a non-conforming value (lowercase, more than two characters, etc.) is rejected with a 400.- PE
base_productmust contain exactly one product. Accepts either a bare string (deprecated) or a single-element array. A Policy Existence payload with a multi-element array is rejected — Policy Limit, by contrast, allows multiplebase_productvalues in one payload.