{"openapi":"3.1.0","info":{"title":"POST /api/v1/reconciliations/{reconciliation_id}/matches/bulk-approve","version":"1.0.0","description":"Bulk approve matches"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/reconciliations/{reconciliation_id}/matches/bulk-approve":{"post":{"tags":["reconciliations"],"summary":"Bulk approve matches","description":"Bulk approve transaction matches.\n\n**Path Parameters:**\n- `reconciliation_id`: UUID of the reconciliation\n\n**Request Body:**\n- `min_confidence`: Minimum AI confidence threshold, 0.0-1.0 (optional, defaults to 0.9)\n- `statement_txn_ids`: Specific statement transaction IDs to approve (optional, overrides min_confidence)\n\n**Note:** Two modes:\n1. **By confidence threshold**: Approve all AI-suggested matches with confidence >= min_confidence\n2. **By specific IDs**: Approve specific statement_txn_ids (overrides threshold)\n\n**Returns:** Updated reconciliation with bulk approved matches.","operationId":"bulk_approve_matches_api_v1_reconciliations__reconciliation_id__matches_bulk_approve_post","parameters":[{"name":"reconciliation_id","in":"path","required":true,"schema":{"type":"string","title":"Reconciliation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkApproveRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_BulkApproveMatchesResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BulkApproveMatchesResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"approved_count":{"type":"integer","title":"Approved Count"},"skipped_count":{"type":"integer","title":"Skipped Count"},"approved":{"items":{"anyOf":[{"$ref":"#/components/schemas/CommittedMatch"},{"additionalProperties":true,"type":"object"}]},"type":"array","title":"Approved","default":[]},"skipped":{"items":{"anyOf":[{"$ref":"#/components/schemas/BulkSkippedMatch"},{"additionalProperties":true,"type":"object"}]},"type":"array","title":"Skipped","default":[]}},"additionalProperties":true,"type":"object","required":["approved_count","skipped_count"],"title":"BulkApproveMatchesResponse","description":"``SuccessEnvelope[BulkApproveMatchesResponse]`` inner payload."},"BulkApproveRequest":{"properties":{"min_confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Confidence","description":"Minimum AI confidence threshold for approval (0.0-1.0)","default":0.9},"statement_txn_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Statement Txn Ids","description":"Specific statement transaction IDs to approve (overrides min_confidence)"}},"type":"object","title":"BulkApproveRequest","description":"Request to bulk approve matches."},"BulkSkippedMatch":{"properties":{"statement_txn_id":{"type":"string","title":"Statement Txn Id"},"reason":{"type":"string","title":"Reason"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"}},"additionalProperties":true,"type":"object","required":["statement_txn_id","reason"],"title":"BulkSkippedMatch"},"CommittedMatch":{"properties":{"statement_txn_id":{"type":"string","title":"Statement Txn Id"},"ledger_txn_ids":{"items":{"type":"string"},"type":"array","title":"Ledger Txn Ids"},"approved_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved By"},"approved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved At"},"was_ai_suggested":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Was Ai Suggested"},"ai_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ai Confidence"},"ai_reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Reasoning"},"bulk_approved":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bulk Approved"}},"additionalProperties":true,"type":"object","required":["statement_txn_id","ledger_txn_ids"],"title":"CommittedMatch","description":"User-approved match."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SuccessEnvelope_BulkApproveMatchesResponse_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"data":{"anyOf":[{"$ref":"#/components/schemas/BulkApproveMatchesResponse"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"SuccessEnvelope[BulkApproveMatchesResponse]"},"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":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}