{"openapi":"3.1.0","info":{"title":"Aarakshak FaceRec API","description":"Sovereign face verification, proctoring continuity, KYC and screen-check API.","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["system"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/health/ready":{"get":{"tags":["system"],"summary":"Health Ready","description":"Deep readiness: model services loaded + template store reachable.\n\n`/health` stays a cheap liveness probe. This one makes real calls, so point\nreadiness probes (not liveness probes) at it.","operationId":"health_ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dashboard":{"get":{"tags":["dashboard"],"summary":"Dashboard","operationId":"dashboard_dashboard_get","security":[{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/contact":{"post":{"tags":["public"],"summary":"Submit a pilot / partnership inquiry from the public landing page.","operationId":"submit_inquiry_api_v1_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_InquirySubmission"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trial-keys/status":{"get":{"tags":["public"],"summary":"Whether self-service trial keys can be minted here.","operationId":"trial_key_status_api_v1_trial_keys_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialKeyStatusResponse"}}}}}}},"/api/v1/trial-keys":{"post":{"tags":["public"],"summary":"Mint a tenant-bound, expiring trial API key for a visitor.","operationId":"create_trial_key_api_v1_trial_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_TrialKeySubmission"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/platform":{"get":{"tags":["platform"],"summary":"Platform Metadata","operationId":"platform_metadata_api_v1_platform_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformMetadataResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/detect":{"post":{"tags":["face-recognition"],"summary":"Detect Face","operationId":"detect_face_api_v1_detect_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_detect_face_api_v1_detect_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/capture/assess":{"post":{"tags":["face-recognition"],"summary":"Assess Capture","operationId":"assess_capture_api_v1_capture_assess_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_assess_capture_api_v1_capture_assess_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureAssessmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/secondary/screen-check":{"post":{"tags":["face-recognition"],"summary":"Secondary Screen Check","operationId":"secondary_screen_check_api_v1_secondary_screen_check_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_secondary_screen_check_api_v1_secondary_screen_check_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenCheckResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/liveness":{"post":{"tags":["face-recognition"],"summary":"Assess Liveness","operationId":"assess_liveness_api_v1_liveness_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_assess_liveness_api_v1_liveness_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LivenessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/kyc/presence-challenge":{"post":{"tags":["face-recognition"],"summary":"Kyc Presence Challenge","operationId":"kyc_presence_challenge_api_v1_kyc_presence_challenge_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_kyc_presence_challenge_api_v1_kyc_presence_challenge_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresenceChallengeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/enroll":{"post":{"tags":["face-recognition"],"summary":"Enroll Face","operationId":"enroll_face_api_v1_enroll_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_enroll_face_api_v1_enroll_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/enroll-template":{"post":{"tags":["face-recognition"],"summary":"Enroll Face Template","operationId":"enroll_face_template_api_v1_enroll_template_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_enroll_face_template_api_v1_enroll_template_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/compare":{"post":{"tags":["face-recognition"],"summary":"Compare Faces","operationId":"compare_faces_api_v1_compare_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_compare_faces_api_v1_compare_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/proctoring/decision":{"post":{"tags":["face-recognition"],"summary":"Proctoring Decision","operationId":"proctoring_decision_api_v1_proctoring_decision_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_proctoring_decision_api_v1_proctoring_decision_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProctoringDecisionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/proctoring/window-decision":{"post":{"tags":["face-recognition"],"summary":"Proctoring Window Decision","description":"Aggregate a window of probe frames into a template for one decision.\n\nMulti-frame aggregation cancels per-frame webcam noise; 5 frames is the\nmeasured sweet spot. No-face probe frames are dropped and counted.","operationId":"proctoring_window_decision_api_v1_proctoring_window_decision_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_proctoring_window_decision_api_v1_proctoring_window_decision_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProctoringWindowDecisionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/kyc/verify":{"post":{"tags":["face-recognition"],"summary":"Kyc Verify","description":"Verify a live selfie against the face on an ID card (e.g. Aadhaar).\n\n`id_image` may be an uploaded card scan, a webcam frame of the card held up,\nor a phone photo of the card -- it must frame only the card. Borderline\nscores route to manual review. Active presence challenge is a separate\ncaller-orchestrated flow; pass `presence_verified=true` only after that\nflow has succeeded.","operationId":"kyc_verify_api_v1_kyc_verify_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_kyc_verify_api_v1_kyc_verify_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KycVerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/kyc/digilocker/auth-url":{"post":{"tags":["face-recognition"],"summary":"Digilocker Auth Url","description":"Create a DigiLocker consent URL for the caller-managed OAuth state.","operationId":"digilocker_auth_url_api_v1_kyc_digilocker_auth_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerAuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/kyc/digilocker/token":{"post":{"tags":["face-recognition"],"summary":"Digilocker Exchange Token","description":"Exchange a DigiLocker authorization code for caller-stored tokens.","operationId":"digilocker_exchange_token_api_v1_kyc_digilocker_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerTokenExchangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/kyc/digilocker/documents":{"get":{"tags":["face-recognition"],"summary":"Digilocker Documents","description":"List issued DigiLocker documents available after user consent.","operationId":"digilocker_documents_api_v1_kyc_digilocker_documents_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"access_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}},{"name":"X-DigiLocker-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Digilocker-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerIssuedFilesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kyc/digilocker/document":{"get":{"tags":["face-recognition"],"summary":"Digilocker Document","description":"Fetch one consented issued document by DigiLocker URI.","operationId":"digilocker_document_api_v1_kyc_digilocker_document_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"uri","in":"query","required":true,"schema":{"type":"string","title":"Uri"}},{"name":"access_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}},{"name":"X-DigiLocker-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Digilocker-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kyc/digilocker/revoke":{"post":{"tags":["face-recognition"],"summary":"Digilocker Revoke","description":"Revoke a DigiLocker access token after the KYC session is complete.","operationId":"digilocker_revoke_api_v1_kyc_digilocker_revoke_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerRevokeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigiLockerRevokeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/find-in-image":{"post":{"tags":["face-recognition"],"summary":"Find Face In Image","operationId":"find_face_in_image_api_v1_find_in_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_find_face_in_image_api_v1_find_in_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindInImageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/verify":{"post":{"tags":["face-recognition"],"summary":"Verify Face","operationId":"verify_face_api_v1_verify_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_verify_face_api_v1_verify_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/search":{"post":{"tags":["face-recognition"],"summary":"Search Face","operationId":"search_face_api_v1_search_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_search_face_api_v1_search_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/user/{subject_id}":{"get":{"tags":["management"],"summary":"Get User","operationId":"get_user_api_v1_user__subject_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"subject_id","in":"path","required":true,"schema":{"type":"string","title":"Subject Id"}},{"name":"tenant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["management"],"summary":"Delete User","description":"Erase a subject: the enrolled template plus any consented fine-tuning\nuploads collected for them (DPDP right to erasure). Idempotent -- deleting\nan unknown subject returns `deleted=false` rather than an error.","operationId":"delete_user_api_v1_user__subject_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"subject_id","in":"path","required":true,"schema":{"type":"string","title":"Subject Id"}},{"name":"tenant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/usage":{"get":{"tags":["management"],"summary":"Get Usage","operationId":"get_usage_api_v1_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tenant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/developer-keys":{"post":{"tags":["developer"],"summary":"Create Developer Key","operationId":"create_developer_key_api_v1_developer_keys_post","security":[{"APIKeyHeader":[]},{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperKeyCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperKeyCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["developer"],"summary":"List Developer Keys","operationId":"list_developer_keys_api_v1_developer_keys_get","security":[{"APIKeyHeader":[]},{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperKeyResponse"},"title":"Response List Developer Keys Api V1 Developer Keys Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/developer-keys/{key_ref}/revoke":{"post":{"tags":["developer"],"summary":"Revoke Developer Key","description":"Revoke a key immediately by its id or display prefix (`fr_live_xxxxxx`).\n\nA leaked key previously stayed valid until someone edited the key table\nby hand; this is the operator-facing kill switch.","operationId":"revoke_developer_key_api_v1_developer_keys__key_ref__revoke_post","security":[{"APIKeyHeader":[]},{"HTTPBasic":[]}],"parameters":[{"name":"key_ref","in":"path","required":true,"schema":{"type":"string","title":"Key Ref"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/secondary/screen-check/events":{"get":{"tags":["management"],"summary":"List Screen Check Events","operationId":"list_screen_check_events_api_v1_secondary_screen_check_events_get","security":[{"APIKeyHeader":[]},{"HTTPBasic":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ScreenCheckEventResponse"},"title":"Response List Screen Check Events Api V1 Secondary Screen Check Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/secondary/screen-check/events/{event_id}/review":{"post":{"tags":["management"],"summary":"Review Screen Check Event","operationId":"review_screen_check_event_api_v1_secondary_screen_check_events__event_id__review_post","security":[{"APIKeyHeader":[]},{"HTTPBasic":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenCheckReviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenCheckEventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/model-metrics":{"get":{"tags":["management"],"summary":"Get Model Metrics","operationId":"get_model_metrics_api_v1_model_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Model Metrics Api V1 Model Metrics Get"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/fine-tuning/uploads":{"post":{"tags":["management"],"summary":"Upload Fine Tuning Dataset","operationId":"upload_fine_tuning_dataset_api_v1_fine_tuning_uploads_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_fine_tuning_dataset_api_v1_fine_tuning_uploads_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuningUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/missing-persons/records":{"post":{"tags":["missing-persons"],"summary":"Register Record","description":"Register a missing person (police), a found person in custody (police or\ncivic body), or an unidentified deceased person (police). The record is\ncross-matched at once; candidates go to the investigators' review queue.\nPhotos are used to build a face template and then discarded.","operationId":"register_record_api_v1_missing_persons_records_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_register_record_api_v1_missing_persons_records_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRegistrationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["missing-persons"],"summary":"List Records","description":"Investigators see every record in their tenant; partners see only the\nrecords their organisation registered.","operationId":"list_records_api_v1_missing_persons_records_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/RecordKind"},{"type":"null"}],"title":"Kind"}},{"name":"record_status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/RecordStatus"},{"type":"null"}],"title":"Record Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecordView"},"title":"Response List Records Api V1 Missing Persons Records Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/records/{record_id}":{"get":{"tags":["missing-persons"],"summary":"Get Record","operationId":"get_record_api_v1_missing_persons_records__record_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/records/{record_id}/close":{"post":{"tags":["missing-persons"],"summary":"Close Record","description":"Close a case and erase its face template immediately. Pending candidate\nmatches involving the record are withdrawn. The metadata tombstone stays\nfor audit.","operationId":"close_record_api_v1_missing_persons_records__record_id__close_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseRecordRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/sightings":{"post":{"tags":["missing-persons"],"summary":"Submit Sighting","description":"Check one photo of a person against open missing-person records.\n\n`reference` is the reason for the search (GD entry, CWC order, rescue\nmemo); it is audited. The photo and its template are not retained.","operationId":"submit_sighting_api_v1_missing_persons_sightings_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_sighting_api_v1_missing_persons_sightings_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SightingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/missing-persons/matches":{"get":{"tags":["missing-persons"],"summary":"List Matches","description":"The investigators' review queue (pending by default).","operationId":"list_matches_api_v1_missing_persons_matches_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"match_status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MatchStatus"},{"type":"null"}],"default":"pending_review","title":"Match Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MatchView"},"title":"Response List Matches Api V1 Missing Persons Matches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/matches/{match_id}/review":{"post":{"tags":["missing-persons"],"summary":"Review Match","description":"Confirm or reject a candidate. Confirming a pair that involves an\nunidentified deceased person requires notes on the independent evidence.","operationId":"review_match_api_v1_missing_persons_matches__match_id__review_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"match_id","in":"path","required":true,"schema":{"type":"string","title":"Match Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewMatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/authorities":{"post":{"tags":["missing-persons"],"summary":"Register Authority","description":"Register a tenant-bound developer key as a police (`investigator`) or\ncivic-body (`partner`) authority. Do this only after the agency's identity\nand data-sharing agreement are verified.","operationId":"register_authority_api_v1_missing_persons_authorities_post","security":[{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["missing-persons"],"summary":"List Authorities","operationId":"list_authorities_api_v1_missing_persons_authorities_get","security":[{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuthorityView"},"title":"Response List Authorities Api V1 Missing Persons Authorities Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/authorities/{key_id}/revoke":{"post":{"tags":["missing-persons"],"summary":"Revoke Authority","operationId":"revoke_authority_api_v1_missing_persons_authorities__key_id__revoke_post","security":[{"HTTPBasic":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/missing-persons/audit":{"get":{"tags":["missing-persons"],"summary":"List Audit","description":"Oversight view of every missing-persons action in a tenant, newest first,\nwith each entry's HMAC signature re-verified.","operationId":"list_audit_api_v1_missing_persons_audit_get","security":[{"HTTPBasic":[]}],"parameters":[{"name":"tenant_id","in":"query","required":true,"schema":{"type":"string","title":"Tenant Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditEntryView"},"title":"Response List Audit Api V1 Missing Persons Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/gallery":{"get":{"tags":["gallery-v2"],"summary":"Gallery Info","description":"The caller's gallery: counts, limits and the model in use.","operationId":"gallery_info_api_v2_gallery_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryInfo"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v2/cases":{"post":{"tags":["gallery-v2"],"summary":"Enrol Case","description":"Enrol one person by opaque case ID (never a name) with 1-5 photos.\n\nEach photo with exactly one face (or the face picked by its box in\n`face_selections`) is enrolled as its own face. Photos are not stored.\nReturns 409 if the case exists, unless `replace=true`.","operationId":"enrol_case_api_v2_cases_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_enrol_case_api_v2_cases_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryEnrolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["gallery-v2"],"summary":"List Cases","description":"Case IDs in the gallery, for reconciliation. Sorted; page with offset.","operationId":"list_cases_api_v2_cases_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":1000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryCaseIdPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/cases/{case_id}/faces":{"post":{"tags":["gallery-v2"],"summary":"Add Faces","description":"Add photos to an existing case without changing its ID.","operationId":"add_faces_api_v2_cases__case_id__faces_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_add_faces_api_v2_cases__case_id__faces_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryEnrolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/cases/{case_id}/metadata":{"put":{"tags":["gallery-v2"],"summary":"Update Metadata","description":"Replace a case's metadata; search filters use it immediately.","operationId":"update_metadata_api_v2_cases__case_id__metadata_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseMetadata"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryCaseView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/cases/{case_id}":{"get":{"tags":["gallery-v2"],"summary":"Get Case","operationId":"get_case_api_v2_cases__case_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryCaseView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["gallery-v2"],"summary":"Delete Case","description":"Delete a person: every face leaves the search index immediately and\nthe case record is erased. Only a hashed, signed receipt is kept.","operationId":"delete_case_api_v2_cases__case_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryDeletionReceipt"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/cases/{case_id}/faces/{face_id}":{"delete":{"tags":["gallery-v2"],"summary":"Delete Face","operationId":"delete_face_api_v2_cases__case_id__faces__face_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}},{"name":"face_id","in":"path","required":true,"schema":{"type":"string","title":"Face Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryCaseView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/search":{"post":{"tags":["gallery-v2"],"summary":"Search","description":"Search one probe photo against the whole gallery.\n\nReturns, for each face in the probe (largest first), the top K cases\nranked by their best face's score. Filters narrow by sex, age today\n(approximate to one year), state and district; cases with the field\nunknown are kept unless `include_unknown=false`.","operationId":"search_api_v2_search_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_search_api_v2_search_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GallerySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v2/jobs/enrol":{"post":{"tags":["gallery-v2"],"summary":"Submit Enrol Job","description":"Asynchronous batch enrolment for backfills.\n\nThe ZIP holds `manifest.json`, shaped as\n`{\"cases\": [{\"case_id\", \"photos\": [file names], \"metadata\": {...}, \"face_selections\": [...]}]}`,\nplus the photo files. The manifest is checked before 202; each case is\nthen enrolled in the background. Poll `GET /jobs/{job_id}` for progress\nand per-item errors. Re-submitting with on_conflict=skip is safe.","operationId":"submit_enrol_job_api_v2_jobs_enrol_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_enrol_job_api_v2_jobs_enrol_post"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryJobView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/jobs/{job_id}":{"get":{"tags":["gallery-v2"],"summary":"Get Job","operationId":"get_job_api_v2_jobs__job_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryJobView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/admin/galleries":{"post":{"tags":["gallery-v2-admin"],"summary":"Create Gallery","description":"Create a gallery for one data owner and issue its first API key. The\nraw key is shown once.","operationId":"create_gallery_api_v2_admin_galleries_post","security":[{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["gallery-v2-admin"],"summary":"List Galleries","operationId":"list_galleries_api_v2_admin_galleries_get","security":[{"HTTPBasic":[]}],"parameters":[{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GalleryAdminView"},"title":"Response List Galleries Api V2 Admin Galleries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/admin/galleries/{gallery_id}/keys":{"post":{"tags":["gallery-v2-admin"],"summary":"Issue Gallery Key","description":"Issue another key for a gallery (rotation, or a sandbox client). Revoke\nold keys with POST /api/v1/developer-keys/{key_ref}/revoke.","operationId":"issue_gallery_key_api_v2_admin_galleries__gallery_id__keys_post","security":[{"HTTPBasic":[]}],"parameters":[{"name":"gallery_id","in":"path","required":true,"schema":{"type":"string","title":"Gallery Id"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/admin/galleries/{gallery_id}":{"delete":{"tags":["gallery-v2-admin"],"summary":"Delete Gallery","description":"End of contract: delete every case and face, revoke every key, and\nreturn a signed deletion certificate.","operationId":"delete_gallery_api_v2_admin_galleries__gallery_id__delete","security":[{"HTTPBasic":[]}],"parameters":[{"name":"gallery_id","in":"path","required":true,"schema":{"type":"string","title":"Gallery Id"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Gallery Api V2 Admin Galleries  Gallery Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AuditEntryView":{"properties":{"entry_id":{"type":"string","title":"Entry Id"},"tenant_id":{"type":"string","title":"Tenant Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"action":{"type":"string","title":"Action"},"outcome":{"type":"string","title":"Outcome"},"key_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Prefix"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"organisation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organisation"},"details":{"additionalProperties":true,"type":"object","title":"Details"},"signature":{"type":"string","title":"Signature"},"signature_valid":{"type":"boolean","title":"Signature Valid"}},"type":"object","required":["entry_id","tenant_id","created_at","action","outcome","key_prefix","role","organisation","details","signature","signature_valid"],"title":"AuditEntryView"},"AuthorityRegisterRequest":{"properties":{"key_ref":{"type":"string","maxLength":120,"minLength":4,"title":"Key Ref"},"role":{"$ref":"#/components/schemas/AuthorityRole"},"organisation":{"type":"string","maxLength":200,"minLength":2,"title":"Organisation"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Jurisdiction"}},"type":"object","required":["key_ref","role","organisation"],"title":"AuthorityRegisterRequest"},"AuthorityRole":{"type":"string","enum":["investigator","partner"],"title":"AuthorityRole"},"AuthorityView":{"properties":{"key_id":{"type":"string","title":"Key Id"},"key_prefix":{"type":"string","title":"Key Prefix"},"tenant_id":{"type":"string","title":"Tenant Id"},"role":{"$ref":"#/components/schemas/AuthorityRole"},"organisation":{"type":"string","title":"Organisation"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"registered_at":{"type":"string","format":"date-time","title":"Registered At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"active":{"type":"boolean","title":"Active"}},"type":"object","required":["key_id","key_prefix","tenant_id","role","organisation","jurisdiction","registered_at","revoked_at","active"],"title":"AuthorityView"},"Body_add_faces_api_v2_cases__case_id__faces_post":{"properties":{"images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Images"},"face_selections":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Face Selections"}},"type":"object","required":["images"],"title":"Body_add_faces_api_v2_cases__case_id__faces_post"},"Body_assess_capture_api_v1_capture_assess_post":{"properties":{"frames":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Frames"}},"type":"object","required":["frames"],"title":"Body_assess_capture_api_v1_capture_assess_post"},"Body_assess_liveness_api_v1_liveness_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"threshold":{"type":"number","title":"Threshold","default":0.45}},"type":"object","required":["image"],"title":"Body_assess_liveness_api_v1_liveness_post"},"Body_compare_faces_api_v1_compare_post":{"properties":{"source_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Source Image"},"target_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Target Image"},"threshold":{"type":"number","title":"Threshold","default":0.3},"preprocessing_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preprocessing Mode"}},"type":"object","required":["source_image","target_image"],"title":"Body_compare_faces_api_v1_compare_post"},"Body_detect_face_api_v1_detect_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"}},"type":"object","required":["image"],"title":"Body_detect_face_api_v1_detect_post"},"Body_enrol_case_api_v2_cases_post":{"properties":{"case_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","title":"Case Id"},"images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Images","description":"1-5 photos of the person"},"face_selections":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Face Selections","description":"JSON list: a box or null per image"},"sex":{"anyOf":[{"type":"string","enum":["female","male","other","unknown"]},{"type":"null"}],"title":"Sex"},"birth_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Birth Year"},"age_at_photo":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Age At Photo"},"photo_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Photo Date"},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code"},"district_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"District Code"},"replace":{"type":"boolean","title":"Replace","default":false}},"type":"object","required":["case_id","images"],"title":"Body_enrol_case_api_v2_cases_post"},"Body_enroll_face_api_v1_enroll_post":{"properties":{"subject_id":{"type":"string","minLength":1,"title":"Subject Id"},"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"}},"type":"object","required":["subject_id","image"],"title":"Body_enroll_face_api_v1_enroll_post"},"Body_enroll_face_template_api_v1_enroll_template_post":{"properties":{"subject_id":{"type":"string","minLength":1,"title":"Subject Id"},"images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Images"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"minimum_template_size":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Minimum Template Size"}},"type":"object","required":["subject_id","images"],"title":"Body_enroll_face_template_api_v1_enroll_template_post"},"Body_find_face_in_image_api_v1_find_in_image_post":{"properties":{"reference_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Reference Image"},"group_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Group Image"},"threshold":{"type":"number","title":"Threshold","default":0.3},"top_k":{"type":"integer","title":"Top K","default":10}},"type":"object","required":["reference_image","group_image"],"title":"Body_find_face_in_image_api_v1_find_in_image_post"},"Body_kyc_presence_challenge_api_v1_kyc_presence_challenge_post":{"properties":{"video":{"type":"string","contentMediaType":"application/octet-stream","title":"Video"},"challenges":{"type":"string","title":"Challenges"}},"type":"object","required":["video","challenges"],"title":"Body_kyc_presence_challenge_api_v1_kyc_presence_challenge_post"},"Body_kyc_verify_api_v1_kyc_verify_post":{"properties":{"selfie_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Selfie Image"},"id_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Id Image"},"verify_threshold":{"type":"number","title":"Verify Threshold","default":0.3},"review_floor":{"type":"number","title":"Review Floor","default":0.12},"minimum_quality":{"type":"number","title":"Minimum Quality","default":0.5},"presence_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Presence Verified"},"registered_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name"},"name_match_threshold":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Name Match Threshold"},"name_match_review_floor":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Name Match Review Floor"}},"type":"object","required":["selfie_image","id_image"],"title":"Body_kyc_verify_api_v1_kyc_verify_post"},"Body_proctoring_decision_api_v1_proctoring_decision_post":{"properties":{"enrollment_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Enrollment Image"},"probe_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Probe Image"},"strict_threshold":{"type":"number","title":"Strict Threshold","default":0.31},"monitor_threshold":{"type":"number","title":"Monitor Threshold","default":0.23},"minimum_quality":{"type":"number","title":"Minimum Quality","default":0.55}},"type":"object","required":["enrollment_image","probe_image"],"title":"Body_proctoring_decision_api_v1_proctoring_decision_post"},"Body_proctoring_window_decision_api_v1_proctoring_window_decision_post":{"properties":{"enrollment_image":{"type":"string","contentMediaType":"application/octet-stream","title":"Enrollment Image"},"probe_images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Probe Images"},"strict_threshold":{"type":"number","title":"Strict Threshold","default":0.31},"monitor_threshold":{"type":"number","title":"Monitor Threshold","default":0.23},"minimum_quality":{"type":"number","title":"Minimum Quality","default":0.55}},"type":"object","required":["enrollment_image","probe_images"],"title":"Body_proctoring_window_decision_api_v1_proctoring_window_decision_post"},"Body_register_record_api_v1_missing_persons_records_post":{"properties":{"kind":{"$ref":"#/components/schemas/RecordKind"},"case_reference":{"type":"string","maxLength":120,"minLength":1,"title":"Case Reference"},"consent_basis":{"$ref":"#/components/schemas/ConsentBasis"},"images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Images"},"consent_party":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Consent Party"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Jurisdiction"},"event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Event Date"},"approx_age":{"anyOf":[{"type":"integer","maximum":120.0,"minimum":0.0},{"type":"null"}],"title":"Approx Age"},"sex":{"anyOf":[{"$ref":"#/components/schemas/Sex"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Notes"}},"type":"object","required":["kind","case_reference","consent_basis"],"title":"Body_register_record_api_v1_missing_persons_records_post"},"Body_search_api_v2_search_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"top_k":{"type":"integer","minimum":1.0,"title":"Top K","default":10},"min_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Min Score"},"sex":{"anyOf":[{"type":"string","enum":["female","male","other"]},{"type":"null"}],"title":"Sex"},"age_min":{"anyOf":[{"type":"integer","maximum":120.0,"minimum":0.0},{"type":"null"}],"title":"Age Min"},"age_max":{"anyOf":[{"type":"integer","maximum":120.0,"minimum":0.0},{"type":"null"}],"title":"Age Max"},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code"},"district_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"District Code"},"include_unknown":{"type":"boolean","title":"Include Unknown","default":true},"max_faces":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Faces"}},"type":"object","required":["image"],"title":"Body_search_api_v2_search_post"},"Body_search_face_api_v1_search_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"top_k":{"type":"integer","title":"Top K","default":5}},"type":"object","required":["image"],"title":"Body_search_face_api_v1_search_post"},"Body_secondary_screen_check_api_v1_secondary_screen_check_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"exam_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exam Id"},"frame_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Frame Id"}},"type":"object","required":["image"],"title":"Body_secondary_screen_check_api_v1_secondary_screen_check_post"},"Body_submit_enrol_job_api_v2_jobs_enrol_post":{"properties":{"archive":{"type":"string","contentMediaType":"application/octet-stream","title":"Archive","description":"ZIP with manifest.json and the photos"},"on_conflict":{"type":"string","enum":["skip","replace"],"title":"On Conflict","default":"skip"}},"type":"object","required":["archive"],"title":"Body_submit_enrol_job_api_v2_jobs_enrol_post"},"Body_submit_sighting_api_v1_missing_persons_sightings_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"reference":{"type":"string","maxLength":200,"minLength":1,"title":"Reference"},"location":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Location"}},"type":"object","required":["image","reference"],"title":"Body_submit_sighting_api_v1_missing_persons_sightings_post"},"Body_upload_fine_tuning_dataset_api_v1_fine_tuning_uploads_post":{"properties":{"subject_id":{"type":"string","minLength":1,"title":"Subject Id"},"images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Images"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"consent":{"type":"boolean","title":"Consent","default":false},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["subject_id"],"title":"Body_upload_fine_tuning_dataset_api_v1_fine_tuning_uploads_post"},"Body_verify_face_api_v1_verify_post":{"properties":{"subject_id":{"type":"string","minLength":1,"title":"Subject Id"},"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"threshold":{"type":"number","title":"Threshold","default":0.3}},"type":"object","required":["subject_id","image"],"title":"Body_verify_face_api_v1_verify_post"},"BoundingBox":{"properties":{"x":{"type":"integer","minimum":0.0,"title":"X"},"y":{"type":"integer","minimum":0.0,"title":"Y"},"width":{"type":"integer","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"integer","exclusiveMinimum":0.0,"title":"Height"}},"type":"object","required":["x","y","width","height"],"title":"BoundingBox"},"CaptureAssessmentResponse":{"properties":{"frames":{"items":{"$ref":"#/components/schemas/CaptureFrameAssessment"},"type":"array","minItems":1,"title":"Frames"},"usable_face_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Usable Face Rate"},"recommend_recapture":{"type":"boolean","title":"Recommend Recapture"},"dominant_guidance":{"type":"string","title":"Dominant Guidance"},"min_usable_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Min Usable Rate"}},"type":"object","required":["frames","usable_face_rate","recommend_recapture","dominant_guidance","min_usable_rate"],"title":"CaptureAssessmentResponse"},"CaptureFailureReason":{"type":"string","enum":["no_face","low_confidence","face_too_small","off_center","no_landmarks","too_dark","too_bright"],"title":"CaptureFailureReason"},"CaptureFrameAssessment":{"properties":{"frame_index":{"type":"integer","minimum":0.0,"title":"Frame Index"},"usable":{"type":"boolean","title":"Usable"},"reasons":{"items":{"$ref":"#/components/schemas/CaptureFailureReason"},"type":"array","title":"Reasons"},"quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Quality Score"},"faces_detected":{"type":"integer","minimum":0.0,"title":"Faces Detected"}},"type":"object","required":["frame_index","usable","quality_score","faces_detected"],"title":"CaptureFrameAssessment"},"CaseMetadata":{"properties":{"sex":{"anyOf":[{"type":"string","enum":["female","male","other","unknown"]},{"type":"null"}],"title":"Sex"},"birth_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Birth Year"},"age_at_photo":{"anyOf":[{"type":"integer","maximum":120.0,"minimum":0.0},{"type":"null"}],"title":"Age At Photo"},"photo_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Photo Date"},"state_code":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]{1,32}$"},{"type":"null"}],"title":"State Code"},"district_code":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]{1,32}$"},{"type":"null"}],"title":"District Code"}},"type":"object","title":"CaseMetadata"},"CloseRecordRequest":{"properties":{"reason":{"$ref":"#/components/schemas/ClosureReason"},"officer_id":{"type":"string","maxLength":120,"minLength":1,"title":"Officer Id"}},"type":"object","required":["reason","officer_id"],"title":"CloseRecordRequest"},"ClosureReason":{"type":"string","enum":["reunited","identified","withdrawn","transferred","duplicate"],"title":"ClosureReason"},"CompareResponse":{"properties":{"match":{"type":"boolean","title":"Match"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"},"confidence":{"type":"string","title":"Confidence"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"},"margin":{"type":"number","title":"Margin"},"embedding_strategy":{"type":"string","title":"Embedding Strategy","default":"crop"},"strategy_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Strategy Scores"},"source_faces":{"items":{"$ref":"#/components/schemas/FaceDetection"},"type":"array","title":"Source Faces"},"target_faces":{"items":{"$ref":"#/components/schemas/FaceDetection"},"type":"array","title":"Target Faces"},"source_quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Source Quality Score"},"target_quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Target Quality Score"},"source_quality":{"anyOf":[{"$ref":"#/components/schemas/FaceQualityAssessment"},{"type":"null"}]},"target_quality":{"anyOf":[{"$ref":"#/components/schemas/FaceQualityAssessment"},{"type":"null"}]},"decision_band":{"type":"string","title":"Decision Band","default":"unknown"},"review_threshold_match":{"type":"boolean","title":"Review Threshold Match","default":false},"improvement_tips":{"items":{"type":"string"},"type":"array","title":"Improvement Tips"}},"type":"object","required":["match","score","confidence","threshold","margin","source_faces","target_faces","source_quality_score","target_quality_score"],"title":"CompareResponse"},"ConsentBasis":{"type":"string","enum":["guardian_consent","self_consent","legal_mandate","court_order"],"title":"ConsentBasis"},"DetectResponse":{"properties":{"faces":{"items":{"$ref":"#/components/schemas/FaceDetection"},"type":"array","title":"Faces"},"count":{"type":"integer","minimum":0.0,"title":"Count"}},"type":"object","required":["faces","count"],"title":"DetectResponse"},"DeveloperKeyCreateRequest":{"properties":{"label":{"type":"string","maxLength":120,"minLength":1,"title":"Label","default":"My application"},"tenant_id":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Tenant Id"},"expires_in_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Expires In Days"}},"type":"object","title":"DeveloperKeyCreateRequest"},"DeveloperKeyCreateResponse":{"properties":{"key_id":{"type":"string","title":"Key Id"},"label":{"type":"string","title":"Label"},"key_prefix":{"type":"string","title":"Key Prefix"},"created_at":{"type":"string","title":"Created At"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"},"active":{"type":"boolean","title":"Active","default":true},"api_key":{"type":"string","title":"Api Key"}},"type":"object","required":["key_id","label","key_prefix","created_at","api_key"],"title":"DeveloperKeyCreateResponse"},"DeveloperKeyResponse":{"properties":{"key_id":{"type":"string","title":"Key Id"},"label":{"type":"string","title":"Label"},"key_prefix":{"type":"string","title":"Key Prefix"},"created_at":{"type":"string","title":"Created At"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"},"active":{"type":"boolean","title":"Active","default":true}},"type":"object","required":["key_id","label","key_prefix","created_at"],"title":"DeveloperKeyResponse"},"DigiLockerAuthRequest":{"properties":{"state":{"type":"string","maxLength":256,"minLength":8,"title":"State"},"nonce":{"anyOf":[{"type":"string","maxLength":256,"minLength":8},{"type":"null"}],"title":"Nonce"}},"type":"object","required":["state"],"title":"DigiLockerAuthRequest"},"DigiLockerAuthResponse":{"properties":{"authorization_url":{"type":"string","title":"Authorization Url"},"state":{"type":"string","title":"State"}},"type":"object","required":["authorization_url","state"],"title":"DigiLockerAuthResponse"},"DigiLockerIssuedDocument":{"properties":{"uri":{"type":"string","title":"Uri"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"doctype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doctype"},"issuer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer"},"issuer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Id"},"mime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime"},"raw":{"additionalProperties":true,"type":"object","title":"Raw"}},"type":"object","required":["uri"],"title":"DigiLockerIssuedDocument"},"DigiLockerIssuedFilesResponse":{"properties":{"documents":{"items":{"$ref":"#/components/schemas/DigiLockerIssuedDocument"},"type":"array","title":"Documents"},"raw":{"additionalProperties":true,"type":"object","title":"Raw"}},"type":"object","required":["documents"],"title":"DigiLockerIssuedFilesResponse"},"DigiLockerRevokeRequest":{"properties":{"access_token":{"type":"string","maxLength":4096,"minLength":1,"title":"Access Token"}},"type":"object","required":["access_token"],"title":"DigiLockerRevokeRequest"},"DigiLockerRevokeResponse":{"properties":{"revoked":{"type":"boolean","title":"Revoked"},"raw":{"additionalProperties":true,"type":"object","title":"Raw"}},"type":"object","required":["revoked"],"title":"DigiLockerRevokeResponse"},"DigiLockerTokenExchangeRequest":{"properties":{"code":{"type":"string","maxLength":4096,"minLength":1,"title":"Code"}},"type":"object","required":["code"],"title":"DigiLockerTokenExchangeRequest"},"DigiLockerTokenResponse":{"properties":{"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"},"refresh_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token"},"id_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Token"},"token_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Type"},"expires_in":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expires In"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"raw":{"additionalProperties":true,"type":"object","title":"Raw"}},"type":"object","title":"DigiLockerTokenResponse"},"EnrollResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"subject_id":{"type":"string","title":"Subject Id"},"embedding_id":{"type":"string","title":"Embedding Id"},"quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Quality Score"},"duplicate_subject_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duplicate Subject Id"},"template_size":{"type":"integer","minimum":1.0,"title":"Template Size","default":1},"frames_submitted":{"type":"integer","minimum":1.0,"title":"Frames Submitted","default":1}},"type":"object","required":["tenant_id","subject_id","embedding_id","quality_score"],"title":"EnrollResponse"},"FaceBox":{"properties":{"x":{"type":"integer","title":"X"},"y":{"type":"integer","title":"Y"},"width":{"type":"integer","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"integer","exclusiveMinimum":0.0,"title":"Height"}},"type":"object","required":["x","y","width","height"],"title":"FaceBox"},"FaceDetection":{"properties":{"bbox":{"$ref":"#/components/schemas/BoundingBox"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"landmarks":{"additionalProperties":{"prefixItems":[{"type":"integer"},{"type":"integer"}],"type":"array","maxItems":2,"minItems":2},"type":"object","title":"Landmarks"},"quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Quality Score"},"head_pose":{"anyOf":[{"$ref":"#/components/schemas/HeadPoseEstimate"},{"type":"null"}]}},"type":"object","required":["bbox","confidence","landmarks","quality_score"],"title":"FaceDetection"},"FaceQualityAssessment":{"properties":{"face_width":{"type":"integer","exclusiveMinimum":0.0,"title":"Face Width"},"face_height":{"type":"integer","exclusiveMinimum":0.0,"title":"Face Height"},"image_width":{"type":"integer","exclusiveMinimum":0.0,"title":"Image Width"},"image_height":{"type":"integer","exclusiveMinimum":0.0,"title":"Image Height"},"face_area_ratio":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Face Area Ratio"},"quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Quality Score"},"detection_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Detection Confidence"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"recommendation":{"type":"string","title":"Recommendation"},"blur_variance":{"type":"number","minimum":0.0,"title":"Blur Variance","default":0.0}},"type":"object","required":["face_width","face_height","image_width","image_height","face_area_ratio","quality_score","detection_confidence","recommendation"],"title":"FaceQualityAssessment"},"FindInImageResponse":{"properties":{"match":{"type":"boolean","title":"Match"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"},"count":{"type":"integer","minimum":0.0,"title":"Count"},"reference_face":{"$ref":"#/components/schemas/FaceDetection"},"group_faces":{"items":{"$ref":"#/components/schemas/FaceDetection"},"type":"array","title":"Group Faces"},"matches":{"items":{"$ref":"#/components/schemas/GroupFaceMatch"},"type":"array","title":"Matches"},"best_match":{"anyOf":[{"$ref":"#/components/schemas/GroupFaceMatch"},{"type":"null"}]}},"type":"object","required":["match","threshold","count","reference_face","group_faces","matches"],"title":"FindInImageResponse"},"FineTuningUploadResponse":{"properties":{"dataset_id":{"type":"string","title":"Dataset Id"},"tenant_id":{"type":"string","title":"Tenant Id"},"subject_id":{"type":"string","title":"Subject Id"},"accepted_images":{"type":"integer","minimum":0.0,"title":"Accepted Images"},"rejected_images":{"type":"integer","minimum":0.0,"title":"Rejected Images"},"status":{"type":"string","title":"Status"},"next_steps":{"items":{"type":"string"},"type":"array","title":"Next Steps"}},"type":"object","required":["dataset_id","tenant_id","subject_id","accepted_images","rejected_images","status","next_steps"],"title":"FineTuningUploadResponse"},"GalleryAdminView":{"properties":{"gallery_id":{"type":"string","title":"Gallery Id"},"label":{"type":"string","title":"Label"},"owner":{"type":"string","title":"Owner"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"key_ids":{"items":{"type":"string"},"type":"array","title":"Key Ids"},"deleted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deleted At"}},"type":"object","required":["gallery_id","label","owner","created_at","key_ids","deleted_at"],"title":"GalleryAdminView"},"GalleryCaseIdPage":{"properties":{"case_ids":{"items":{"type":"string"},"type":"array","title":"Case Ids"},"total":{"type":"integer","title":"Total"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["case_ids","total","offset","limit"],"title":"GalleryCaseIdPage"},"GalleryCaseView":{"properties":{"case_id":{"type":"string","title":"Case Id"},"metadata":{"$ref":"#/components/schemas/CaseMetadata"},"faces":{"items":{"$ref":"#/components/schemas/GalleryFaceView"},"type":"array","title":"Faces"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["case_id","metadata","faces","created_at","updated_at"],"title":"GalleryCaseView"},"GalleryCreateRequest":{"properties":{"gallery_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","title":"Gallery Id"},"label":{"type":"string","maxLength":120,"minLength":1,"title":"Label"},"owner":{"type":"string","maxLength":200,"minLength":1,"title":"Owner"},"expires_in_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Expires In Days"}},"type":"object","required":["gallery_id","label","owner"],"title":"GalleryCreateRequest"},"GalleryDeletionReceipt":{"properties":{"case_id":{"type":"string","title":"Case Id"},"case_id_sha256":{"type":"string","title":"Case Id Sha256"},"faces_deleted":{"type":"integer","title":"Faces Deleted"},"deleted_at":{"type":"string","title":"Deleted At"},"signature":{"type":"string","title":"Signature"}},"type":"object","required":["case_id","case_id_sha256","faces_deleted","deleted_at","signature"],"title":"GalleryDeletionReceipt"},"GalleryEnrolResponse":{"properties":{"case":{"$ref":"#/components/schemas/GalleryCaseView"},"photos":{"items":{"$ref":"#/components/schemas/GalleryPhotoResult"},"type":"array","title":"Photos"},"faces_enrolled":{"type":"integer","title":"Faces Enrolled"},"model":{"$ref":"#/components/schemas/GalleryModelInfo"},"idempotent_replay":{"type":"boolean","title":"Idempotent Replay","default":false}},"type":"object","required":["case","photos","faces_enrolled","model"],"title":"GalleryEnrolResponse"},"GalleryFaceView":{"properties":{"face_id":{"type":"string","title":"Face Id"},"box":{"$ref":"#/components/schemas/FaceBox"},"quality_score":{"type":"number","title":"Quality Score"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"enrolled_at":{"type":"string","format":"date-time","title":"Enrolled At"}},"type":"object","required":["face_id","box","quality_score","warnings","enrolled_at"],"title":"GalleryFaceView"},"GalleryInfo":{"properties":{"gallery_id":{"type":"string","title":"Gallery Id"},"label":{"type":"string","title":"Label"},"owner":{"type":"string","title":"Owner"},"case_count":{"type":"integer","title":"Case Count"},"face_count":{"type":"integer","title":"Face Count"},"limits":{"additionalProperties":true,"type":"object","title":"Limits"},"model":{"$ref":"#/components/schemas/GalleryModelInfo"}},"type":"object","required":["gallery_id","label","owner","case_count","face_count","limits","model"],"title":"GalleryInfo"},"GalleryJobView":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["queued","running","completed","failed"],"title":"Status"},"on_conflict":{"type":"string","title":"On Conflict"},"total":{"type":"integer","title":"Total"},"processed":{"type":"integer","title":"Processed"},"enrolled":{"type":"integer","title":"Enrolled"},"skipped":{"type":"integer","title":"Skipped"},"failed":{"type":"integer","title":"Failed"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"stale":{"type":"boolean","title":"Stale","default":false},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors"}},"type":"object","required":["job_id","status","on_conflict","total","processed","enrolled","skipped","failed","created_at","updated_at"],"title":"GalleryJobView"},"GalleryKeyRequest":{"properties":{"label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Label"},"expires_in_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Expires In Days"}},"type":"object","title":"GalleryKeyRequest"},"GalleryKeyResponse":{"properties":{"gallery_id":{"type":"string","title":"Gallery Id"},"key_id":{"type":"string","title":"Key Id"},"key_prefix":{"type":"string","title":"Key Prefix"},"api_key":{"type":"string","title":"Api Key"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["gallery_id","key_id","key_prefix","api_key","expires_at"],"title":"GalleryKeyResponse"},"GalleryMatch":{"properties":{"case_id":{"type":"string","title":"Case Id"},"face_id":{"type":"string","title":"Face Id"},"score":{"type":"number","title":"Score"}},"type":"object","required":["case_id","face_id","score"],"title":"GalleryMatch"},"GalleryModelInfo":{"properties":{"model_version":{"type":"string","title":"Model Version"},"embedding_model":{"type":"string","title":"Embedding Model"},"score":{"type":"string","title":"Score"}},"type":"object","required":["model_version","embedding_model","score"],"title":"GalleryModelInfo"},"GalleryPhotoResult":{"properties":{"photo_index":{"type":"integer","title":"Photo Index"},"status":{"type":"string","enum":["enrolled","no_face","multiple_faces","face_not_found_at_box","face_too_small"],"title":"Status"},"face_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Face Id"},"faces_detected":{"type":"integer","title":"Faces Detected"},"box":{"anyOf":[{"$ref":"#/components/schemas/FaceBox"},{"type":"null"}]},"detected_boxes":{"items":{"$ref":"#/components/schemas/FaceBox"},"type":"array","title":"Detected Boxes"},"quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quality Score"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["photo_index","status","face_id","faces_detected","box","detected_boxes","quality_score","warnings"],"title":"GalleryPhotoResult"},"GalleryProbeFace":{"properties":{"box":{"$ref":"#/components/schemas/FaceBox"},"quality_score":{"type":"number","title":"Quality Score"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"matches":{"items":{"$ref":"#/components/schemas/GalleryMatch"},"type":"array","title":"Matches"}},"type":"object","required":["box","quality_score","warnings","matches"],"title":"GalleryProbeFace"},"GallerySearchResponse":{"properties":{"gallery_id":{"type":"string","title":"Gallery Id"},"faces_detected":{"type":"integer","title":"Faces Detected"},"faces":{"items":{"$ref":"#/components/schemas/GalleryProbeFace"},"type":"array","title":"Faces"},"top_k":{"type":"integer","title":"Top K"},"min_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Score"},"model":{"$ref":"#/components/schemas/GalleryModelInfo"}},"type":"object","required":["gallery_id","faces_detected","faces","top_k","min_score","model"],"title":"GallerySearchResponse"},"GroupFaceMatch":{"properties":{"face_index":{"type":"integer","minimum":0.0,"title":"Face Index"},"match":{"type":"boolean","title":"Match"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"},"confidence":{"type":"string","title":"Confidence"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"},"margin":{"type":"number","title":"Margin"},"embedding_strategy":{"type":"string","title":"Embedding Strategy"},"face":{"$ref":"#/components/schemas/FaceDetection"},"strategy_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Strategy Scores"}},"type":"object","required":["face_index","match","score","confidence","threshold","margin","embedding_strategy","face"],"title":"GroupFaceMatch"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HeadPoseEstimate":{"properties":{"yaw_degrees":{"type":"number","title":"Yaw Degrees"},"pitch_degrees":{"type":"number","title":"Pitch Degrees"},"roll_degrees":{"type":"number","title":"Roll Degrees"},"looking_away":{"type":"boolean","title":"Looking Away"},"method":{"type":"string","title":"Method","default":"five_point_geometry"}},"type":"object","required":["yaw_degrees","pitch_degrees","roll_degrees","looking_away"],"title":"HeadPoseEstimate","description":"Approximate head pose from the detector's five landmarks.\n\nAdvisory only: derived from 2-D landmark geometry (no 3-D model fit), so\ntreat the degrees as coarse buckets, not measurements. `looking_away` is the\nproduct-level read (\"candidate is not facing the camera\") that proctoring\nsurfaces as a non-gating reason."},"InquiryResponse":{"properties":{"status":{"type":"string","title":"Status","default":"received"},"reference_id":{"type":"string","title":"Reference Id"}},"type":"object","required":["reference_id"],"title":"InquiryResponse"},"InquirySolution":{"type":"string","enum":["pariksha","praveshan","upasthiti","api","suraksha","khoj","jeevan","vitaran","chikitsa"],"title":"InquirySolution"},"InquiryWorkflow":{"type":"string","enum":["attendance","live_proctoring","kyc_id_vs_camera","security_access","other"],"title":"InquiryWorkflow"},"KycVerificationResponse":{"properties":{"decision":{"type":"string","title":"Decision"},"verified":{"type":"boolean","title":"Verified"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"},"verify_threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Verify Threshold"},"review_floor":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Review Floor"},"confidence":{"type":"string","title":"Confidence"},"id_quality":{"anyOf":[{"$ref":"#/components/schemas/FaceQualityAssessment"},{"type":"null"}]},"selfie_quality":{"anyOf":[{"$ref":"#/components/schemas/FaceQualityAssessment"},{"type":"null"}]},"faces_on_id":{"type":"integer","minimum":0.0,"title":"Faces On Id","default":0},"faces_in_selfie":{"type":"integer","minimum":0.0,"title":"Faces In Selfie","default":0},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"recommended_action":{"type":"string","title":"Recommended Action"},"review_required":{"type":"boolean","title":"Review Required"},"liveness_checked":{"type":"boolean","title":"Liveness Checked","default":false},"presence_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Presence Verified"},"embedding_strategy":{"type":"string","title":"Embedding Strategy","default":"original"},"name_match_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Name Match Score","default":0.0},"name_match_decision":{"type":"string","title":"Name Match Decision","default":"not_requested"},"name_match_reasons":{"items":{"type":"string"},"type":"array","title":"Name Match Reasons"},"name_match_extracted_name":{"type":"string","title":"Name Match Extracted Name","default":""},"name_match_registered_normalized":{"type":"string","title":"Name Match Registered Normalized","default":""},"name_match_threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Name Match Threshold","default":0.82},"name_match_review_floor":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Name Match Review Floor","default":0.62},"name_match_ocr_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Name Match Ocr Confidence"},"document_detected":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Document Detected"},"document_type_candidate":{"type":"string","title":"Document Type Candidate","default":""},"engine_version":{"type":"string","title":"Engine Version","default":""},"request_id":{"type":"string","title":"Request Id","default":""}},"type":"object","required":["decision","verified","score","verify_threshold","review_floor","confidence","recommended_action","review_required"],"title":"KycVerificationResponse"},"LivenessResponse":{"properties":{"live":{"type":"boolean","title":"Live"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"quality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Quality Score"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["live","score","quality_score","reasons"],"title":"LivenessResponse"},"MatchStatus":{"type":"string","enum":["pending_review","confirmed","rejected","withdrawn"],"title":"MatchStatus"},"MatchView":{"properties":{"match_id":{"type":"string","title":"Match Id"},"missing_record_id":{"type":"string","title":"Missing Record Id"},"counterpart_kind":{"type":"string","title":"Counterpart Kind"},"counterpart_id":{"type":"string","title":"Counterpart Id"},"score":{"type":"number","title":"Score"},"status":{"$ref":"#/components/schemas/MatchStatus"},"post_mortem_review_required":{"type":"boolean","title":"Post Mortem Review Required"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"reviewed_by_officer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By Officer"},"reviewed_by_organisation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By Organisation"},"review_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Notes"},"advisory":{"type":"string","title":"Advisory"}},"type":"object","required":["match_id","missing_record_id","counterpart_kind","counterpart_id","score","status","post_mortem_review_required","created_at","reviewed_at","reviewed_by_officer","reviewed_by_organisation","review_notes","advisory"],"title":"MatchView"},"PlatformMetadataResponse":{"properties":{"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"api_prefix":{"type":"string","title":"Api Prefix"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"integrations":{"items":{"type":"string"},"type":"array","title":"Integrations"},"liveness_backend":{"type":"string","title":"Liveness Backend","default":"heuristic"},"liveness_is_presentation_attack_detection":{"type":"boolean","title":"Liveness Is Presentation Attack Detection","default":false},"screen_check_backend":{"type":"string","title":"Screen Check Backend","default":"stub"},"screen_check_rollout_mode":{"$ref":"#/components/schemas/ScreenCheckRolloutMode","default":"stub"},"detection_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detection Provider"},"embedding_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embedding Provider"},"embedding_preprocessing_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embedding Preprocessing Mode"},"arcface_backend_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Arcface Backend Hint"},"embedding_dimension":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Embedding Dimension"},"storage_backend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Storage Backend"},"engine_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engine Version"}},"type":"object","required":["name","version","api_prefix","capabilities","integrations"],"title":"PlatformMetadataResponse"},"PresenceChallengeResponse":{"properties":{"presence_verified":{"type":"boolean","title":"Presence Verified"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"challenges_passed":{"type":"integer","minimum":0.0,"title":"Challenges Passed"},"challenges_total":{"type":"integer","minimum":0.0,"title":"Challenges Total"},"audit_trail":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Audit Trail"},"backend":{"type":"string","title":"Backend","default":"active_challenge"}},"type":"object","required":["presence_verified","score","challenges_passed","challenges_total"],"title":"PresenceChallengeResponse"},"ProctoringDecisionResponse":{"properties":{"decision":{"type":"string","title":"Decision"},"risk_level":{"type":"string","title":"Risk Level"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"},"margin":{"type":"number","title":"Margin"},"face_quality":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Face Quality"},"source_quality":{"anyOf":[{"$ref":"#/components/schemas/FaceQualityAssessment"},{"type":"null"}]},"target_quality":{"anyOf":[{"$ref":"#/components/schemas/FaceQualityAssessment"},{"type":"null"}]},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"recommended_action":{"type":"string","title":"Recommended Action"},"review_required":{"type":"boolean","title":"Review Required"},"recapture_required":{"type":"boolean","title":"Recapture Required"},"faces_in_frame":{"type":"integer","minimum":0.0,"title":"Faces In Frame","default":1},"multiple_faces_detected":{"type":"boolean","title":"Multiple Faces Detected","default":false},"embedding_strategy":{"type":"string","title":"Embedding Strategy","default":"crop"},"camera_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Camera State"},"continuity_signal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Continuity Signal"},"head_pose":{"anyOf":[{"$ref":"#/components/schemas/HeadPoseEstimate"},{"type":"null"}]}},"type":"object","required":["decision","risk_level","score","threshold","margin","face_quality","recommended_action","review_required","recapture_required"],"title":"ProctoringDecisionResponse"},"ProctoringWindowDecisionResponse":{"properties":{"decision":{"type":"string","title":"Decision"},"risk_level":{"type":"string","title":"Risk Level"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"},"margin":{"type":"number","title":"Margin"},"frames_submitted":{"type":"integer","minimum":0.0,"title":"Frames Submitted"},"frames_with_face":{"type":"integer","minimum":0.0,"title":"Frames With Face"},"frames_no_face":{"type":"integer","minimum":0.0,"title":"Frames No Face"},"template_size":{"type":"integer","minimum":0.0,"title":"Template Size"},"face_quality":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Face Quality"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"recommended_action":{"type":"string","title":"Recommended Action"},"review_required":{"type":"boolean","title":"Review Required"},"recapture_required":{"type":"boolean","title":"Recapture Required"},"multiple_faces_detected":{"type":"boolean","title":"Multiple Faces Detected","default":false},"max_faces_in_a_frame":{"type":"integer","minimum":0.0,"title":"Max Faces In A Frame","default":0},"embedding_strategy":{"type":"string","title":"Embedding Strategy","default":"original_mean_template"},"camera_state_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Camera State Counts"},"continuity_signals":{"items":{"type":"string"},"type":"array","title":"Continuity Signals"},"score_median":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score Median","default":0.0},"score_min":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score Min","default":0.0},"score_max":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score Max","default":0.0},"frames_matching":{"type":"integer","minimum":0.0,"title":"Frames Matching","default":0},"match_fraction":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Match Fraction","default":0.0},"frames_low_quality_dropped":{"type":"integer","minimum":0.0,"title":"Frames Low Quality Dropped","default":0},"mixed_identity_in_window":{"type":"boolean","title":"Mixed Identity In Window","default":false},"frames_looking_away":{"type":"integer","minimum":0.0,"title":"Frames Looking Away","default":0}},"type":"object","required":["decision","risk_level","score","threshold","margin","frames_submitted","frames_with_face","frames_no_face","template_size","face_quality","recommended_action","review_required","recapture_required"],"title":"ProctoringWindowDecisionResponse"},"RecordKind":{"type":"string","enum":["missing","found","unidentified_deceased"],"title":"RecordKind"},"RecordRegistrationResponse":{"properties":{"record":{"$ref":"#/components/schemas/RecordView"},"candidate_matches":{"type":"integer","title":"Candidate Matches"},"matches":{"items":{"$ref":"#/components/schemas/MatchView"},"type":"array","title":"Matches"},"referred_for_review":{"type":"boolean","title":"Referred For Review"},"advisory":{"type":"string","title":"Advisory","default":"Candidate for human review only. A similarity score is not an identification: confirm through independent evidence before any action."}},"type":"object","required":["record","candidate_matches","matches","referred_for_review"],"title":"RecordRegistrationResponse"},"RecordStatus":{"type":"string","enum":["open","closed"],"title":"RecordStatus"},"RecordView":{"properties":{"record_id":{"type":"string","title":"Record Id"},"kind":{"$ref":"#/components/schemas/RecordKind"},"status":{"$ref":"#/components/schemas/RecordStatus"},"case_reference":{"type":"string","title":"Case Reference"},"consent_basis":{"$ref":"#/components/schemas/ConsentBasis"},"consent_party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consent Party"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Event Date"},"approx_age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Approx Age"},"sex":{"anyOf":[{"$ref":"#/components/schemas/Sex"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"owner_organisation":{"type":"string","title":"Owner Organisation"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"template_size":{"type":"integer","title":"Template Size"},"quality_score":{"type":"number","title":"Quality Score"},"biometric_erased":{"type":"boolean","title":"Biometric Erased"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At"},"closure_reason":{"anyOf":[{"$ref":"#/components/schemas/ClosureReason"},{"type":"null"}]},"photos_stored":{"type":"boolean","title":"Photos Stored","default":false}},"type":"object","required":["record_id","kind","status","case_reference","consent_basis","consent_party","jurisdiction","event_date","approx_age","sex","notes","owner_organisation","created_at","template_size","quality_score","biometric_erased","closed_at","closure_reason"],"title":"RecordView"},"ReviewDecision":{"type":"string","enum":["confirmed","rejected"],"title":"ReviewDecision"},"ReviewMatchRequest":{"properties":{"decision":{"$ref":"#/components/schemas/ReviewDecision"},"officer_id":{"type":"string","maxLength":120,"minLength":1,"title":"Officer Id"},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes"}},"type":"object","required":["decision","officer_id"],"title":"ReviewMatchRequest"},"ScreenCheckEventResponse":{"properties":{"event_id":{"type":"string","title":"Event Id"},"exam_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exam Id"},"frame_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Frame Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"signature":{"type":"string","title":"Signature"},"review":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Review"},"review_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Signature"}},"type":"object","required":["event_id","created_at","payload","signature"],"title":"ScreenCheckEventResponse"},"ScreenCheckResponse":{"properties":{"risk_tier":{"$ref":"#/components/schemas/ScreenRiskTier"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"exam_ui_visible":{"type":"boolean","title":"Exam Ui Visible"},"signals":{"items":{"$ref":"#/components/schemas/ScreenSignal"},"type":"array","title":"Signals"},"model_version":{"type":"string","title":"Model Version"},"evidence_timestamp":{"type":"string","format":"date-time","title":"Evidence Timestamp","description":"UTC timestamp when the screen evidence decision was produced."},"frame_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Frame Id"},"exam_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exam Id"},"crop":{"anyOf":[{"$ref":"#/components/schemas/ScreenCropMetadata"},{"type":"null"}]},"incident":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incident"},"rollout_mode":{"$ref":"#/components/schemas/ScreenCheckRolloutMode","default":"stub"},"review_required":{"type":"boolean","title":"Review Required","default":false},"action":{"type":"string","title":"Action","default":"log_only"},"event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Id"}},"type":"object","required":["risk_tier","confidence","exam_ui_visible","model_version"],"title":"ScreenCheckResponse"},"ScreenCheckReviewDecision":{"type":"string","enum":["confirmed","dismissed","escalated"],"title":"ScreenCheckReviewDecision"},"ScreenCheckReviewRequest":{"properties":{"decision":{"$ref":"#/components/schemas/ScreenCheckReviewDecision"},"reviewer_id":{"type":"string","maxLength":120,"minLength":1,"title":"Reviewer Id"},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes"}},"type":"object","required":["decision","reviewer_id"],"title":"ScreenCheckReviewRequest"},"ScreenCheckRolloutMode":{"type":"string","enum":["stub","shadow","review","consensus"],"title":"ScreenCheckRolloutMode"},"ScreenCropMetadata":{"properties":{"cropped":{"type":"boolean","title":"Cropped"},"x":{"type":"integer","minimum":0.0,"title":"X"},"y":{"type":"integer","minimum":0.0,"title":"Y"},"width":{"type":"integer","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"integer","exclusiveMinimum":0.0,"title":"Height"},"image_width":{"type":"integer","exclusiveMinimum":0.0,"title":"Image Width"},"image_height":{"type":"integer","exclusiveMinimum":0.0,"title":"Image Height"},"screen_area_ratio":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Screen Area Ratio"}},"type":"object","required":["cropped","x","y","width","height","image_width","image_height","screen_area_ratio"],"title":"ScreenCropMetadata"},"ScreenRiskTier":{"type":"string","enum":["tier_0_block","tier_1_flag","tier_2_audit","tier_3_clean"],"title":"ScreenRiskTier"},"ScreenSignal":{"type":"string","enum":["live_answer_panel","ai_overlay","answer_overlay","on_screen_prompt","external_browser","ide_assistant","second_screen","no_screen_detected","off_screen_handoff","vlm_timeout"],"title":"ScreenSignal"},"SearchMatch":{"properties":{"subject_id":{"type":"string","title":"Subject Id"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"}},"type":"object","required":["subject_id","score"],"title":"SearchMatch"},"SearchResponse":{"properties":{"matches":{"items":{"$ref":"#/components/schemas/SearchMatch"},"type":"array","title":"Matches"},"count":{"type":"integer","minimum":0.0,"title":"Count"}},"type":"object","required":["matches","count"],"title":"SearchResponse"},"Sex":{"type":"string","enum":["female","male","other"],"title":"Sex"},"SightingResponse":{"properties":{"sighting_id":{"type":"string","title":"Sighting Id"},"candidate_matches":{"type":"integer","title":"Candidate Matches"},"referred_for_review":{"type":"boolean","title":"Referred For Review"},"matches":{"items":{"$ref":"#/components/schemas/MatchView"},"type":"array","title":"Matches"},"photo_retained":{"type":"boolean","title":"Photo Retained","default":false},"advisory":{"type":"string","title":"Advisory","default":"Candidate for human review only. A similarity score is not an identification: confirm through independent evidence before any action."}},"type":"object","required":["sighting_id","candidate_matches","referred_for_review","matches"],"title":"SightingResponse"},"SubjectDeleteResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"subject_id":{"type":"string","title":"Subject Id"},"deleted":{"type":"boolean","title":"Deleted"},"fine_tuning_datasets_deleted":{"type":"integer","minimum":0.0,"title":"Fine Tuning Datasets Deleted","default":0}},"type":"object","required":["tenant_id","subject_id","deleted"],"title":"SubjectDeleteResponse","description":"Outcome of erasing a subject (DPDP right to erasure)."},"TrialKeyResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"key_prefix":{"type":"string","title":"Key Prefix"},"tenant_id":{"type":"string","title":"Tenant Id"},"label":{"type":"string","title":"Label"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"type":"string","title":"Expires At"},"base_url":{"type":"string","title":"Base Url"},"docs_url":{"type":"string","title":"Docs Url"},"rate_limit_per_minute":{"type":"integer","title":"Rate Limit Per Minute"}},"type":"object","required":["api_key","key_prefix","tenant_id","label","created_at","expires_at","base_url","docs_url","rate_limit_per_minute"],"title":"TrialKeyResponse","description":"A freshly minted self-service trial key. `api_key` is shown exactly once;\nonly its hash is stored, so a lost key means minting another."},"TrialKeyStatusResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"expiry_days":{"type":"integer","title":"Expiry Days"},"base_url":{"type":"string","title":"Base Url"}},"type":"object","required":["enabled","expiry_days","base_url"],"title":"TrialKeyStatusResponse"},"UsageResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"enrolled_subjects":{"type":"integer","minimum":0.0,"title":"Enrolled Subjects"},"embedding_dimension":{"type":"integer","exclusiveMinimum":0.0,"title":"Embedding Dimension"},"storage_backend":{"type":"string","title":"Storage Backend"},"detection_model":{"type":"string","title":"Detection Model"},"recognition_model":{"type":"string","title":"Recognition Model"}},"type":"object","required":["tenant_id","enrolled_subjects","embedding_dimension","storage_backend","detection_model","recognition_model"],"title":"UsageResponse"},"UserDetailsResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"subject_id":{"type":"string","title":"Subject Id"},"enrolled":{"type":"boolean","title":"Enrolled"},"embedding_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embedding Id"},"quality_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Quality Score"}},"type":"object","required":["tenant_id","subject_id","enrolled"],"title":"UserDetailsResponse"},"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"},"VerifyResponse":{"properties":{"match":{"type":"boolean","title":"Match"},"score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Score"},"confidence":{"type":"string","title":"Confidence"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"},"subject_id":{"type":"string","title":"Subject Id"},"embedding_strategy":{"type":"string","title":"Embedding Strategy","default":"crop"}},"type":"object","required":["match","score","confidence","threshold","subject_id"],"title":"VerifyResponse"},"_InquirySubmission":{"properties":{"name":{"type":"string","maxLength":200,"minLength":2,"title":"Name"},"email":{"type":"string","maxLength":200,"minLength":5,"title":"Email"},"organization":{"type":"string","maxLength":200,"minLength":2,"title":"Organization"},"role":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Role"},"solutions":{"items":{"$ref":"#/components/schemas/InquirySolution"},"type":"array","maxItems":10,"title":"Solutions"},"workflows":{"items":{"$ref":"#/components/schemas/InquiryWorkflow"},"type":"array","maxItems":10,"title":"Workflows"},"message":{"type":"string","maxLength":5000,"minLength":10,"title":"Message"},"_website":{"type":"string","maxLength":500,"title":"Website","default":""}},"type":"object","required":["name","email","organization","message"],"title":"_InquirySubmission","description":"Wire payload: the public schema plus a honeypot trap field bots fill in."},"_TrialKeySubmission":{"properties":{"name":{"type":"string","maxLength":200,"minLength":2,"title":"Name"},"email":{"type":"string","maxLength":200,"minLength":5,"title":"Email"},"organization":{"type":"string","maxLength":200,"minLength":2,"title":"Organization"},"role":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Role"},"use_case":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Use Case"},"_website":{"type":"string","maxLength":500,"title":"Website","default":""}},"type":"object","required":["name","email","organization"],"title":"_TrialKeySubmission"}},"securitySchemes":{"HTTPBasic":{"type":"http","scheme":"basic"},"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}