{"openapi":"3.1.0","info":{"title":"GET /api/v1/advisory-firms/{firm_id}/candidates/{candidate_id}/context","version":"1.0.0","description":"Drill-in context for one match candidate"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/advisory-firms/{firm_id}/candidates/{candidate_id}/context":{"get":{"tags":["intercompany-cleanup"],"summary":"Drill-in context for one match candidate","description":"Full journal lines per leg plus the history of confirmed pairs between the same two accounts — everything needed to judge the candidate without leaving the review queue.","operationId":"get_candidate_context_api_v1_advisory_firms__firm_id__candidates__candidate_id__context_get","parameters":[{"name":"firm_id","in":"path","required":true,"schema":{"type":"string","title":"Firm Id"}},{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","title":"Candidate Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CandidateContextResponse_"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"404":{"description":"Not Found - Resource does not exist","content":{"application/json":{"example":{"detail":"Resource not found"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CandidateContextResponse":{"properties":{"candidate":{"$ref":"#/components/schemas/MatchCandidateResponse"},"leg_a_lines":{"items":{"$ref":"#/components/schemas/JournalLineRow"},"type":"array","title":"Leg A Lines"},"leg_b_lines":{"items":{"$ref":"#/components/schemas/JournalLineRow"},"type":"array","title":"Leg B Lines"},"similar_pairs":{"items":{"$ref":"#/components/schemas/SimilarPairRow"},"type":"array","title":"Similar Pairs"}},"type":"object","required":["candidate"],"title":"CandidateContextResponse","description":"Drill-in payload: judge a candidate without leaving the queue."},"CandidateLeg":{"properties":{"transaction_id":{"type":"string","title":"Transaction Id"},"business_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Id"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"amount_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Cents"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"}},"type":"object","required":["transaction_id"],"title":"CandidateLeg","description":"One side of a candidate, ready for mirror-layout rendering."},"ExpectedCounterparty":{"properties":{"map_entry_id":{"type":"string","title":"Map Entry Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"}},"type":"object","required":["map_entry_id"],"title":"ExpectedCounterparty","description":"Where the engine believes the missing leg lives (Case B)."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JournalLineRow":{"properties":{"line_id":{"type":"string","title":"Line Id"},"ledger_id":{"type":"string","title":"Ledger Id"},"ledger_name":{"type":"string","title":"Ledger Name"},"debit_credit":{"type":"string","title":"Debit Credit"},"amount_cents":{"type":"integer","title":"Amount Cents"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["line_id","ledger_id","ledger_name","debit_credit","amount_cents"],"title":"JournalLineRow"},"MatchCandidateResponse":{"properties":{"id":{"type":"string","title":"Id"},"cleanup_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cleanup Session Id"},"case_type":{"type":"string","title":"Case Type"},"status":{"type":"string","title":"Status"},"amount_cents":{"type":"integer","title":"Amount Cents"},"date_delta_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Date Delta Days"},"confidence":{"type":"integer","title":"Confidence"},"confidence_factors":{"additionalProperties":true,"type":"object","title":"Confidence Factors"},"leg_a":{"anyOf":[{"$ref":"#/components/schemas/CandidateLeg"},{"type":"null"}]},"leg_b":{"anyOf":[{"$ref":"#/components/schemas/CandidateLeg"},{"type":"null"}]},"expected_counterparty":{"anyOf":[{"$ref":"#/components/schemas/ExpectedCounterparty"},{"type":"null"}]},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","case_type","status","amount_cents","confidence"],"title":"MatchCandidateResponse","description":"A proposed pair or classified orphan with its explanation."},"SimilarPairRow":{"properties":{"candidate_id":{"type":"string","title":"Candidate Id"},"amount_cents":{"type":"integer","title":"Amount Cents"},"status":{"type":"string","title":"Status"},"date_delta_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Date Delta Days"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["candidate_id","amount_cents","status"],"title":"SimilarPairRow"},"SuccessEnvelope_CandidateContextResponse_":{"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/CandidateContextResponse"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"SuccessEnvelope[CandidateContextResponse]"},"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":[]}]}