{"openapi":"3.1.0","info":{"title":"POST /api/v1/reconciliations/{reconciliation_id}/matches/approve","version":"1.0.0","description":"Approve match"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/reconciliations/{reconciliation_id}/matches/approve":{"post":{"tags":["reconciliations"],"summary":"Approve match","description":"Approve a transaction match.\n\n**Path Parameters:**\n- `reconciliation_id`: UUID of the reconciliation\n\n**Request Body:**\n- `statement_txn_id`: Statement transaction ID to match (required)\n- `ledger_txn_ids`: Array of ledger transaction IDs to match (required)\n\n**Note:** Can approve AI-suggested matches or create manual matches.\n\n**Returns:** Updated reconciliation with approved match.","operationId":"approve_match_api_v1_reconciliations__reconciliation_id__matches_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/MatchApprovalRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ApproveMatchResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ApproveMatchResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"match":{"anyOf":[{"$ref":"#/components/schemas/CommittedMatch"},{"additionalProperties":true,"type":"object"}],"title":"Match"}},"additionalProperties":true,"type":"object","required":["match"],"title":"ApproveMatchResponse","description":"``SuccessEnvelope[ApproveMatchResponse]`` inner payload."},"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"},"MatchApprovalRequest":{"properties":{"statement_txn_id":{"type":"string","title":"Statement Txn Id","description":"Statement transaction ID"},"ledger_txn_ids":{"items":{"type":"string"},"type":"array","title":"Ledger Txn Ids","description":"Ledger transaction IDs to match"}},"type":"object","required":["statement_txn_id","ledger_txn_ids"],"title":"MatchApprovalRequest","description":"Request to approve a transaction match."},"SuccessEnvelope_ApproveMatchResponse_":{"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/ApproveMatchResponse"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"SuccessEnvelope[ApproveMatchResponse]"},"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":[]}]}