{"openapi":"3.1.0","info":{"title":"DF-24-18010 AI Litigation Search API","version":"1.0.0","description":"Read-only search and filing-detail API for the local DF-24-18010 litigation database."},"servers":[{"url":"https://jason-primary-m2.tail1774a2.ts.net"}],"security":[{"bearerAuth":[]}],"paths":{"/api/ai/health":{"get":{"operationId":"getHealth","summary":"Check API and database health.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/manifest":{"get":{"operationId":"getManifest","summary":"Get API capabilities, filters, and examples.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManifestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/search":{"get":{"operationId":"searchFilings","summary":"Search filings or page text with optional category filters.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search terms."},{"name":"collection","in":"query","schema":{"type":"string","enum":["filings","pages"],"default":"filings"}},{"name":"filing_search","in":"query","schema":{"type":"string","enum":["type","title","content","exhibits"],"default":"content"}},{"name":"mode","in":"query","schema":{"type":"string","enum":["exact","semantic","hybrid"],"default":"hybrid"}},{"name":"category","in":"query","schema":{"type":"string"},"description":"Imported category field such as is_healthcare."},{"name":"quick","in":"query","schema":{"type":"string"},"description":"Quick filter id such as no_ruling_no_hearing."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"group_by","in":"query","schema":{"type":"string","enum":["filing","page"],"default":"filing"},"description":"Default returns one grouped result per filing; page returns page results."},{"name":"debug","in":"query","schema":{"type":"boolean","default":false},"description":"When true, include raw snippets and category suggestion reasons."},{"name":"include_suggestion_reasons","in":"query","schema":{"type":"boolean","default":false},"description":"When true, include suggestion_reasons even if debug is false."},{"name":"include_text","in":"query","schema":{"type":"boolean","default":false},"description":"Include text snippets/page text in results."},{"name":"text_chars","in":"query","schema":{"type":"integer","minimum":0,"maximum":6000,"default":1200},"description":"Maximum page-text characters when include_text is true."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/filing/{filing_id}":{"get":{"operationId":"getFiling","summary":"Get filing detail, categories, pages, and source metadata.","parameters":[{"name":"filing_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include_pages","in":"query","schema":{"type":"boolean","default":true}},{"name":"include_text","in":"query","schema":{"type":"boolean","default":false}},{"name":"page_limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":200}},{"name":"text_chars","in":"query","schema":{"type":"integer","minimum":0,"maximum":6000,"default":1200}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/categories":{"get":{"operationId":"getCategories","summary":"List imported category and quick filters.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/audit":{"get":{"operationId":"getAudit","summary":"Get category import audit information.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"FlexibleObject":{"type":"object","properties":{},"additionalProperties":true},"ErrorResponse":{"type":"object","properties":{"detail":{"type":"string"}}},"HealthResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"database_ready":{"type":"boolean"},"token_required":{"type":"boolean"},"app":{"type":"string"},"database_path":{"type":"string"},"server_time":{"type":"string"}}},"ManifestStatus":{"type":"object","properties":{"database_ready":{"type":"boolean"},"filings_indexed":{"type":"integer"},"pages_indexed":{"type":"integer"},"category_rows_imported":{"type":"integer"},"category_rows_matched":{"type":"integer"},"category_rows_unmatched":{"type":"integer"},"filings_with_categories":{"type":"integer"},"filings_without_categories":{"type":"integer"},"category_needs_review":{"type":"integer"},"rows_unmatched":{"type":"integer"},"suggestions_generated":{"type":"integer"},"high_confidence_suggestions":{"type":"integer"},"medium_confidence_suggestions":{"type":"integer"},"low_confidence_suggestions":{"type":"integer"},"no_suggestion":{"type":"integer"},"suggested_by_companion":{"type":"integer"}}},"CategoryFilter":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"}}},"QuickFilter":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}}},"EndpointInfo":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"},"purpose":{"type":"string"},"common_params":{"type":"array","items":{"type":"string"}}}},"ManifestResponse":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"base_url":{"type":"string"},"token_required":{"type":"boolean"},"openapi_for_actions":{"type":"string"},"human_help_page":{"type":"string"},"status":{"$ref":"#/components/schemas/ManifestStatus"},"category_filters":{"type":"array","items":{"$ref":"#/components/schemas/CategoryFilter"}},"quick_filters":{"type":"array","items":{"$ref":"#/components/schemas/QuickFilter"}},"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/EndpointInfo"}},"examples":{"type":"array","items":{"type":"string"}},"citation_rules":{"type":"array","items":{"type":"string"}}}},"CategorySuggestion":{"type":"object","properties":{"suggested_categories":{"type":"array","items":{"type":"string"}},"suggestion_confidence":{"type":"string"},"suggestion_score":{"type":"number"},"companion_filing_id":{"type":"integer"},"needs_human_review":{"type":"boolean"},"approved":{"type":"boolean"},"rejected":{"type":"boolean"},"suggestion_reasons":{"type":"string"},"suggestion_source":{"type":"string"},"companion_match_reason":{"type":"string"}}},"PageSnippet":{"type":"object","properties":{"page_number":{"type":"integer"},"page_role":{"type":"string"},"clean_snippet":{"type":"string"},"raw_snippet":{"type":"string"},"pdf_page_url":{"type":"string"},"text":{"type":"string"},"text_truncated":{"type":"boolean"}}},"SearchResult":{"type":"object","properties":{"filing_id":{"type":"integer"},"pleading_number":{"type":"string"},"clean_title":{"type":"string"},"original_filename":{"type":"string"},"filing_date":{"type":"string"},"filer":{"type":"string"},"event_type":{"type":"string"},"page_count":{"type":"integer"},"categories":{"type":"array","items":{"type":"string"}},"category_needs_review":{"type":"boolean"},"category_suggestion":{"$ref":"#/components/schemas/CategorySuggestion"},"suggestion_summary":{"$ref":"#/components/schemas/CategorySuggestion"},"status_label":{"type":"string"},"category_import_confidence":{"type":"number"},"filing_url":{"type":"string"},"pdf_url":{"type":"string"},"download_url":{"type":"string"},"citation":{"type":"string"},"page_uid":{"type":"string"},"page_number":{"type":"integer"},"page_role":{"type":"string"},"needs_ocr":{"type":"boolean"},"pdf_page_url":{"type":"string"},"best_page_number":{"type":"integer"},"best_page_url":{"type":"string"},"matched_page_count":{"type":"integer"},"clean_snippet":{"type":"string"},"raw_snippet":{"type":"string"},"excerpt":{"type":"string"},"suggestion_reasons":{"type":"string"},"snippets":{"type":"array","items":{"$ref":"#/components/schemas/PageSnippet"}},"text":{"type":"string"},"text_truncated":{"type":"boolean"},"text_chars":{"type":"integer"}}},"SearchResponse":{"type":"object","properties":{"query":{"type":"string"},"collection":{"type":"string"},"group_by":{"type":"string"},"filing_search":{"type":"string"},"mode":{"type":"string"},"category":{"type":"string"},"quick":{"type":"string"},"limit":{"type":"integer"},"text_chars":{"type":"integer"},"debug":{"type":"boolean"},"include_suggestion_reasons":{"type":"boolean"},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}}}},"ImportedCategoryRow":{"type":"object","properties":{"pleading_number":{"type":"string"},"source_row":{"type":"integer"},"categories":{"type":"array","items":{"type":"string"}},"status_label":{"type":"string"},"import_confidence":{"type":"number"},"document_filename":{"type":"string"},"actual_uploaded_filename":{"type":"string"},"expected_document_filename":{"type":"string"},"import_notes":{"type":"string"}}},"FilingPage":{"type":"object","properties":{"page_uid":{"type":"string"},"page_number":{"type":"integer"},"page_role":{"type":"string"},"exhibit_label":{"type":"string"},"needs_ocr":{"type":"boolean"},"pdf_page_url":{"type":"string"},"excerpt":{"type":"string"},"text":{"type":"string"},"text_truncated":{"type":"boolean"}}},"SourceMetadata":{"type":"object","properties":{"original_filename":{"type":"string"},"pdf_path":{"type":"string"},"category_import_source":{"type":"string"},"expected_document_filename":{"type":"string"},"actual_uploaded_filename":{"type":"string"},"clean_display_title":{"type":"string"}}},"FilingResponse":{"type":"object","properties":{"filing":{"$ref":"#/components/schemas/SearchResult"},"topics":{"type":"array","items":{"type":"string"}},"imported_category_rows":{"type":"array","items":{"$ref":"#/components/schemas/ImportedCategoryRow"}},"source_metadata":{"$ref":"#/components/schemas/SourceMetadata"},"pages":{"type":"array","items":{"$ref":"#/components/schemas/FilingPage"}}}},"CategoryResponse":{"type":"object","properties":{"category_filters":{"type":"array","items":{"$ref":"#/components/schemas/CategoryFilter"}},"quick_filters":{"type":"array","items":{"$ref":"#/components/schemas/QuickFilter"}}}},"AuditResponse":{"type":"object","properties":{"imported":{"type":"boolean"},"database_ready":{"type":"boolean"},"rows_imported":{"type":"integer"},"rows_matched_to_filings":{"type":"integer"},"rows_unmatched":{"type":"integer"},"low_confidence_matches":{"type":"integer"},"filings_with_categories":{"type":"integer"},"filings_without_categories":{"type":"integer"},"category_needs_review":{"type":"integer"},"match_confidence":{"type":"array","items":{"$ref":"#/components/schemas/FlexibleObject"}},"duplicate_match_rows":{"type":"array","items":{"$ref":"#/components/schemas/FlexibleObject"}},"candidate_ambiguity_rows":{"type":"array","items":{"$ref":"#/components/schemas/FlexibleObject"}},"unmatched_rows":{"type":"array","items":{"$ref":"#/components/schemas/FlexibleObject"}},"missing_pdf_rows":{"type":"array","items":{"$ref":"#/components/schemas/FlexibleObject"}},"category_counts_by_flag":{"type":"object","properties":{},"additionalProperties":{"type":"integer"}},"category_import_source":{"type":"string"},"category_imported_at":{"type":"string"}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}