{"openapi":"3.1.0","info":{"title":"XoSeen — full API","version":"0.1.0","description":"Every endpoint across matching, ML, verification, encryption, web-support and realtime in one spec."},"paths":{"/health/live":{"get":{"summary":"Health Live","description":"Liveness: the process is up (cheap; for the LB to keep it in rotation).","operationId":"health_live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Live Health Live Get"}}}}},"tags":["core"]}},"/health/ready":{"get":{"summary":"Health Ready","description":"Readiness: the app can serve (always true via graceful fallbacks), with\nany active degradation surfaced so traffic decisions / alerts can react.","operationId":"health_ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Ready Health Ready Get"}}}}},"tags":["core"]}},"/healthz":{"get":{"summary":"Healthz","description":"Aggregated health dashboard across all subsystems + degradation modes.","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Healthz Healthz Get"}}}}},"tags":["core"]}},"/api/list":{"get":{"summary":"Api List","description":"Machine-readable catalog of every endpoint across all subsystems.","operationId":"api_list_api_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Api List Api List Get"}}}}},"tags":["core"]}},"/api":{"get":{"summary":"Api Explorer","operationId":"api_explorer_api_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"tags":["core"]}},"/doc":{"get":{"summary":"Mobile Doc","description":"Mobile integration guide: every endpoint, in the order a client calls them.\n\n/api answers \"what endpoints exist\"; /api/docs answers \"what is the schema\".\nNeither answers \"what do I call first\" — which is the only question someone\nbuilding the client actually has. That's this page.","operationId":"mobile_doc_doc_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"tags":["core"]}},"/doc/json":{"get":{"summary":"Mobile Doc Json","description":"The mobile integration guide as structured JSON (stages, order, endpoints).","operationId":"mobile_doc_json_doc_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mobile Doc Json Doc Json Get"}}}}},"tags":["core"]}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"tags":["core"]}},"/info":{"get":{"summary":"Info","operationId":"info_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Info Info Get"}}}}},"tags":["core"]}},"/web/feed":{"get":{"summary":"Web Feed","operationId":"web_feed_web_feed_get","parameters":[{"name":"viewerId","in":"query","required":false,"schema":{"type":"string","default":"usr_1","title":"Viewerid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Feed Web Feed Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/web/action":{"post":{"summary":"Web Action","operationId":"web_action_web_action_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.ActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Action Web Action Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/web/blind/next":{"post":{"summary":"Web Blind Next","operationId":"web_blind_next_web_blind_next_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.BlindRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Blind Next Web Blind Next Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/web/blind/reveal":{"post":{"summary":"Web Blind Reveal","operationId":"web_blind_reveal_web_blind_reveal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.RevealRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Blind Reveal Web Blind Reveal Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/web/suggestions":{"get":{"summary":"Web Suggestions","operationId":"web_suggestions_web_suggestions_get","parameters":[{"name":"viewerId","in":"query","required":true,"schema":{"type":"string","title":"Viewerid"}},{"name":"candidateId","in":"query","required":true,"schema":{"type":"string","title":"Candidateid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Suggestions Web Suggestions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/web/reply-suggest":{"post":{"summary":"Web Reply Suggest","operationId":"web_reply_suggest_web_reply_suggest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.ReplySuggestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Reply Suggest Web Reply Suggest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/web/safety/incidents":{"get":{"summary":"Web Safety Incidents","operationId":"web_safety_incidents_web_safety_incidents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Safety Incidents Web Safety Incidents Get"}}}}},"tags":["core"]}},"/web/learning/stats":{"get":{"summary":"Web Learning Stats","operationId":"web_learning_stats_web_learning_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Learning Stats Web Learning Stats Get"}}}}},"tags":["core"]}},"/web/profile":{"post":{"summary":"Web Profile","operationId":"web_profile_web_profile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.ProfileRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Web Profile Web Profile Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core.HTTPValidationError"}}}}},"tags":["core"]}},"/live":{"get":{"summary":"Live","operationId":"live_live_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"tags":["core"]}},"/console":{"get":{"summary":"Console","operationId":"console_console_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"tags":["core"]}},"/playground":{"get":{"summary":"Playground","operationId":"playground_playground_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"tags":["core"]}},"/match/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Health Get"}}}}},"tags":["match"]}},"/match/ai/match/rank":{"post":{"summary":"Rank","operationId":"rank_ai_match_rank_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/match.RankRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/match.RankResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/match.HTTPValidationError"}}}}},"tags":["match"]}},"/match/ai/match/explain":{"post":{"summary":"Explain","operationId":"explain_ai_match_explain_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/match.ExplainRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/match.ExplainResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/match.HTTPValidationError"}}}}},"tags":["match"]}},"/verify/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Health Get"}}}}},"tags":["verify"]}},"/verify/verification/submit":{"post":{"summary":"Submit","operationId":"submit_verification_submit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.RawSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.DecisionSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.HTTPValidationError"}}}}},"tags":["verify"]}},"/verify/verification/verify-live":{"post":{"summary":"Verify Live","description":"Real end-to-end: store the uploaded images + run the verification pipeline.\n\nThe date of birth is read from the ID image when OCR (OpenAI vision) is\nconfigured; the `dob` form field is only a fallback used if the ID can't be\nread. A non-empty `dob` must still be a valid ISO date.","operationId":"verify_live_verification_verify_live_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/verify.Body_verify_live_verification_verify_live_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.DecisionSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.HTTPValidationError"}}}}},"tags":["verify"]}},"/verify/verification/verify-images":{"post":{"summary":"Verify Images","description":"Run ALL checks on each provided image + cross-match the faces.\n\nPer-image: decodable, face count, quality, AI/deepfake/tamper forensics, and\nfor an ID the OCR'd DOB / doc type / 18+ / tamper. Plus a face-match summary\n(selfie vs ID and each photo). Each image and the whole set get a verdict\n(pass | review | fail). This is a standalone validator — it does not record a\ntrust decision (use /verify-live for that).","operationId":"verify_images_verification_verify_images_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/verify.Body_verify_images_verification_verify_images_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.HTTPValidationError"}}}}},"tags":["verify"]}},"/verify/verification/status/{user_id}":{"get":{"summary":"Status","operationId":"status_verification_status__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.DecisionSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.HTTPValidationError"}}}}},"tags":["verify"]}},"/verify/verification/trust/{user_id}":{"get":{"summary":"Trust","operationId":"trust_verification_trust__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.TrustSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.HTTPValidationError"}}}}},"tags":["verify"]}},"/verify/verification/review/pending":{"get":{"summary":"Pending Reviews","operationId":"pending_reviews_verification_review_pending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/verify.ReviewSummary"},"type":"array","title":"Response Pending Reviews Verification Review Pending Get"}}}}},"tags":["verify"]}},"/verify/verification/review/resolve":{"post":{"summary":"Resolve","operationId":"resolve_verification_review_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.ResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verify.HTTPValidationError"}}}}},"tags":["verify"]}},"/verify/verification/reverification/due":{"get":{"summary":"Reverification Due","operationId":"reverification_due_verification_reverification_due_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"tags":["verify"]}},"/ml/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Health Get"}}}}},"tags":["ml"]}},"/ml/viewers":{"get":{"summary":"Viewers","operationId":"viewers_viewers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Viewers Viewers Get"}}}}},"tags":["ml"]}},"/ml/rank":{"post":{"summary":"Rank","operationId":"rank_rank_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.MLRankRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.RankResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.HTTPValidationError"}}}}},"tags":["ml"]}},"/ml/explain":{"post":{"summary":"Explain","operationId":"explain_explain_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.MLExplainRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.ExplainResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.HTTPValidationError"}}}}},"tags":["ml"]}},"/ml/weights":{"get":{"summary":"Weights","description":"The real, configured weights/knobs the matching algorithm uses.","operationId":"weights_weights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Weights Weights Get"}}}}},"tags":["ml"]}},"/ml/score":{"post":{"summary":"Score","description":"Compute compatibility + two-sided final using the REAL scoring code.","operationId":"score_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.ScoreRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Score Score Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.HTTPValidationError"}}}}},"tags":["ml"]}},"/ml/feedback":{"post":{"summary":"Feedback","operationId":"feedback_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.MLFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ml.HTTPValidationError"}}}}},"tags":["ml"]}},"/e2ee/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Health Get"}}}}},"tags":["e2ee"]}},"/e2ee/keys":{"post":{"summary":"Register Key","operationId":"register_key_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/e2ee.RegisterKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Register Key Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/e2ee.HTTPValidationError"}}}}},"tags":["e2ee"]}},"/e2ee/keys/{user_id}":{"get":{"summary":"Get Key","operationId":"get_key_keys__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/e2ee.HTTPValidationError"}}}}},"tags":["e2ee"]}},"/e2ee/alerts":{"get":{"summary":"Alerts","operationId":"alerts_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Alerts Alerts Get"}}}}},"tags":["e2ee"]}}},"components":{"schemas":{"core.ActionRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"candidateId":{"type":"string","minLength":1,"title":"Candidateid"},"action":{"type":"string","title":"Action"}},"type":"object","required":["viewerId","candidateId","action"],"title":"ActionRequest"},"core.BlindRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"}},"type":"object","required":["viewerId"],"title":"BlindRequest"},"core.HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/core.ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"core.ProfileRequest":{"properties":{"userId":{"type":"string","minLength":1,"title":"Userid"},"displayName":{"type":"string","maxLength":40,"minLength":1,"title":"Displayname"},"intent":{"type":"string","title":"Intent","default":"long_term"},"interests":{"items":{"type":"string"},"type":"array","title":"Interests"},"cityArea":{"type":"string","title":"Cityarea","default":"Manhattan"},"ageDisplayed":{"type":"integer","maximum":120.0,"minimum":18.0,"title":"Agedisplayed"},"trustScore":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Trustscore"},"ageMin":{"type":"integer","maximum":120.0,"minimum":18.0,"title":"Agemin","default":25},"ageMax":{"type":"integer","maximum":120.0,"minimum":18.0,"title":"Agemax","default":45},"maxDistanceKm":{"type":"number","exclusiveMinimum":0.0,"title":"Maxdistancekm","default":60.0},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"seeking":{"items":{"type":"string"},"type":"array","title":"Seeking"},"orientation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Orientation"},"asexual":{"type":"boolean","title":"Asexual","default":false},"asexualOnly":{"type":"boolean","title":"Asexualonly","default":false}},"type":"object","required":["userId","displayName","ageDisplayed","trustScore"],"title":"ProfileRequest"},"core.ReplySuggestRequest":{"properties":{"user":{"type":"string","minLength":1,"title":"User"},"history":{"items":{"type":"object"},"type":"array","title":"History"}},"type":"object","required":["user"],"title":"ReplySuggestRequest"},"core.RevealRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"candidateId":{"type":"string","minLength":1,"title":"Candidateid"}},"type":"object","required":["viewerId","candidateId"],"title":"RevealRequest"},"core.ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"match.ExplainBreakdown":{"properties":{"trust":{"type":"number","title":"Trust"},"intent":{"type":"number","title":"Intent"},"interests":{"type":"number","title":"Interests"},"texting_style":{"type":"number","title":"Texting Style"},"location":{"type":"number","title":"Location"},"p_like_back":{"type":"number","title":"P Like Back"},"final":{"type":"number","title":"Final"}},"additionalProperties":false,"type":"object","required":["trust","intent","interests","texting_style","location","p_like_back","final"],"title":"ExplainBreakdown"},"match.ExplainRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"candidateId":{"type":"string","minLength":1,"title":"Candidateid"}},"additionalProperties":false,"type":"object","required":["viewerId","candidateId"],"title":"ExplainRequest"},"match.ExplainResponse":{"properties":{"explanation":{"type":"string","title":"Explanation"},"breakdown":{"$ref":"#/components/schemas/match.ExplainBreakdown"}},"type":"object","required":["explanation","breakdown"],"title":"ExplainResponse"},"match.HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/match.ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"match.MatchResult":{"properties":{"candidateId":{"type":"string","title":"Candidateid"},"displayName":{"type":"string","title":"Displayname"},"ageDisplayed":{"type":"integer","title":"Agedisplayed"},"cityArea":{"type":"string","title":"Cityarea"},"verifiedBadge":{"type":"boolean","title":"Verifiedbadge"},"sharedInterests":{"items":{"type":"string"},"type":"array","title":"Sharedinterests"},"explanation":{"type":"string","title":"Explanation"},"score":{"type":"number","title":"Score"},"photoUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photourl"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"}},"additionalProperties":false,"type":"object","required":["candidateId","displayName","ageDisplayed","cityArea","verifiedBadge","sharedInterests","explanation","score"],"title":"MatchResult","description":"The ONLY candidate shape returned to clients. No PII, by construction."},"match.RankRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20}},"additionalProperties":false,"type":"object","required":["viewerId"],"title":"RankRequest"},"match.RankResponse":{"properties":{"candidates":{"items":{"$ref":"#/components/schemas/match.MatchResult"},"type":"array","title":"Candidates"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextcursor"}},"type":"object","required":["candidates"],"title":"RankResponse"},"match.ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"verify.Body_verify_images_verification_verify_images_post":{"properties":{"id_document":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"Id Document"},"selfie":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"Selfie"},"profile_photos":{"items":{"type":"string","format":"binary"},"type":"array","title":"Profile Photos","default":[]}},"type":"object","title":"Body_verify_images_verification_verify_images_post"},"verify.Body_verify_live_verification_verify_live_post":{"properties":{"user_id":{"type":"string","minLength":1,"title":"User Id"},"dob":{"type":"string","title":"Dob","default":""},"assistive_context":{"type":"string","title":"Assistive Context","default":"none"},"doc_type":{"type":"string","title":"Doc Type","default":"state_id"},"id_document":{"type":"string","format":"binary","title":"Id Document"},"selfie":{"type":"string","format":"binary","title":"Selfie"},"profile_photos":{"items":{"type":"string","format":"binary"},"type":"array","title":"Profile Photos","default":[]}},"type":"object","required":["user_id","id_document","selfie"],"title":"Body_verify_live_verification_verify_live_post"},"verify.DecisionSummary":{"properties":{"userId":{"type":"string","title":"Userid"},"decision":{"type":"string","title":"Decision"},"trustScore":{"type":"number","title":"Trustscore"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"reverifyBy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reverifyby"},"ageOver18":{"type":"boolean","title":"Ageover18","default":false},"ageDisplayed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agedisplayed"}},"additionalProperties":false,"type":"object","required":["userId","decision","trustScore","reasons"],"title":"DecisionSummary"},"verify.HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/verify.ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"verify.RawSubmission":{"properties":{"user_id":{"type":"string","title":"User Id"},"id_document_ref":{"type":"string","title":"Id Document Ref"},"selfie_ref":{"type":"string","title":"Selfie Ref"},"profile_photo_refs":{"items":{"type":"string"},"type":"array","title":"Profile Photo Refs"},"assistive_context":{"type":"string","title":"Assistive Context","default":"none"}},"additionalProperties":false,"type":"object","required":["user_id","id_document_ref","selfie_ref"],"title":"RawSubmission"},"verify.ResolveRequest":{"properties":{"userId":{"type":"string","minLength":1,"title":"Userid"},"approved":{"type":"boolean","title":"Approved"},"reviewer":{"type":"string","minLength":1,"title":"Reviewer"},"note":{"type":"string","title":"Note","default":""}},"additionalProperties":false,"type":"object","required":["userId","approved","reviewer"],"title":"ResolveRequest"},"verify.ReviewSummary":{"properties":{"userId":{"type":"string","title":"Userid"},"trustScore":{"type":"number","title":"Trustscore"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["userId","trustScore","reasons"],"title":"ReviewSummary"},"verify.TrustSummary":{"properties":{"userId":{"type":"string","title":"Userid"},"verified":{"type":"boolean","title":"Verified"},"trustScore":{"type":"number","title":"Trustscore"}},"type":"object","required":["userId","verified","trustScore"],"title":"TrustSummary"},"verify.ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ml.ExplainBreakdown":{"properties":{"trust":{"type":"number","title":"Trust"},"intent":{"type":"number","title":"Intent"},"interests":{"type":"number","title":"Interests"},"texting_style":{"type":"number","title":"Texting Style"},"location":{"type":"number","title":"Location"},"p_like_back":{"type":"number","title":"P Like Back"},"final":{"type":"number","title":"Final"}},"additionalProperties":false,"type":"object","required":["trust","intent","interests","texting_style","location","p_like_back","final"],"title":"ExplainBreakdown"},"ml.ExplainResponse":{"properties":{"explanation":{"type":"string","title":"Explanation"},"breakdown":{"$ref":"#/components/schemas/ml.ExplainBreakdown"}},"type":"object","required":["explanation","breakdown"],"title":"ExplainResponse"},"ml.HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ml.ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ml.MLExplainRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"candidateId":{"type":"string","minLength":1,"title":"Candidateid"}},"additionalProperties":false,"type":"object","required":["viewerId","candidateId"],"title":"MLExplainRequest"},"ml.MLFeedbackRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"candidateId":{"type":"string","minLength":1,"title":"Candidateid"},"action":{"type":"string","pattern":"^(like|pass)$","title":"Action"}},"additionalProperties":false,"type":"object","required":["viewerId","candidateId","action"],"title":"MLFeedbackRequest"},"ml.MLRankRequest":{"properties":{"viewerId":{"type":"string","minLength":1,"title":"Viewerid"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"additionalProperties":false,"type":"object","required":["viewerId"],"title":"MLRankRequest"},"ml.MatchResult":{"properties":{"candidateId":{"type":"string","title":"Candidateid"},"displayName":{"type":"string","title":"Displayname"},"ageDisplayed":{"type":"integer","title":"Agedisplayed"},"cityArea":{"type":"string","title":"Cityarea"},"verifiedBadge":{"type":"boolean","title":"Verifiedbadge"},"sharedInterests":{"items":{"type":"string"},"type":"array","title":"Sharedinterests"},"explanation":{"type":"string","title":"Explanation"},"score":{"type":"number","title":"Score"},"photoUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photourl"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"}},"additionalProperties":false,"type":"object","required":["candidateId","displayName","ageDisplayed","cityArea","verifiedBadge","sharedInterests","explanation","score"],"title":"MatchResult","description":"The ONLY candidate shape returned to clients. No PII, by construction."},"ml.RankResponse":{"properties":{"candidates":{"items":{"$ref":"#/components/schemas/ml.MatchResult"},"type":"array","title":"Candidates"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextcursor"}},"type":"object","required":["candidates"],"title":"RankResponse"},"ml.ScoreRequest":{"properties":{"trust":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Trust","default":0.5},"intent":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Intent","default":0.5},"interests":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Interests","default":0.5},"texting_style":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Texting Style","default":0.5},"location":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Location","default":0.5},"p_like_back":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Like Back","default":0.5},"blind_date_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Blind Date Fit","default":0.5},"safety":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Safety","default":1.0},"inbound_likes":{"type":"integer","minimum":0.0,"title":"Inbound Likes","default":0},"weights":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Weights"}},"additionalProperties":false,"type":"object","title":"ScoreRequest","description":"Raw sub-scores for the matching-algorithm playground."},"ml.ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"e2ee.HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/e2ee.ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"e2ee.RegisterKeyRequest":{"properties":{"userId":{"type":"string","minLength":1,"title":"Userid"},"publicKey":{"type":"string","minLength":1,"title":"Publickey"}},"additionalProperties":false,"type":"object","required":["userId","publicKey"],"title":"RegisterKeyRequest"},"e2ee.ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"core"},{"name":"match"},{"name":"verify"},{"name":"ml"},{"name":"e2ee"}]}