{"service":"HALOWERK aialignwerk","endpoint":"/v1/bias-audit","method":"POST","content_type":"application/json","inputSchema":{"type":"object","required":["groups"],"additionalProperties":false,"properties":{"groups":{"type":"array","minItems":2,"maxItems":1000,"items":{"type":"object","required":["group_id","total_count","positive_count"],"additionalProperties":false,"properties":{"group_id":{"type":"string","minLength":1,"maxLength":128},"total_count":{"type":"integer","minimum":1,"maximum":1000000000},"positive_count":{"type":"integer","minimum":0,"maximum":1000000000}}}},"reference_group_id":{"type":"string","minLength":1,"maxLength":128},"minimum_selection_rate_ratio":{"type":"number","minimum":0,"maximum":1}}},"requestExample":{"groups":[{"group_id":"group-a","total_count":500,"positive_count":310},{"group_id":"group-b","total_count":420,"positive_count":210},{"group_id":"group-c","total_count":380,"positive_count":228}],"reference_group_id":"group-a","minimum_selection_rate_ratio":0.8},"operations":[{"method":"POST","inputSchema":{"type":"object","required":["groups"],"additionalProperties":false,"properties":{"groups":{"type":"array","minItems":2,"maxItems":1000,"items":{"type":"object","required":["group_id","total_count","positive_count"],"additionalProperties":false,"properties":{"group_id":{"type":"string","minLength":1,"maxLength":128},"total_count":{"type":"integer","minimum":1,"maximum":1000000000},"positive_count":{"type":"integer","minimum":0,"maximum":1000000000}}}},"reference_group_id":{"type":"string","minLength":1,"maxLength":128},"minimum_selection_rate_ratio":{"type":"number","minimum":0,"maximum":1}}},"requestExample":{"groups":[{"group_id":"group-a","total_count":500,"positive_count":310},{"group_id":"group-b","total_count":420,"positive_count":210},{"group_id":"group-c","total_count":380,"positive_count":228}],"reference_group_id":"group-a","minimum_selection_rate_ratio":0.8}}],"example_request":{"groups":[{"group_id":"group-a","total_count":500,"positive_count":310},{"group_id":"group-b","total_count":420,"positive_count":210},{"group_id":"group-c","total_count":380,"positive_count":228}],"reference_group_id":"group-a","minimum_selection_rate_ratio":0.8},"serviceName":"HALOWERK aialignwerk","tags":["iot","bias","fairness"],"outputSchema":{"type":"object","required":["method"],"properties":{"method":{"type":"string"}},"additionalProperties":true},"outputExample":{"reference_group_id":"group-a","comparisons":[{"group_id":"group-a","positive_rate":0.62,"rate_difference_from_reference":0,"selection_rate_ratio":1,"below_supplied_ratio_threshold":false},{"group_id":"group-b","positive_rate":0.5,"rate_difference_from_reference":-0.12,"selection_rate_ratio":0.806451613,"below_supplied_ratio_threshold":false},{"group_id":"group-c","positive_rate":0.6,"rate_difference_from_reference":-0.02,"selection_rate_ratio":0.967741935,"below_supplied_ratio_threshold":false}],"maximum_rate_gap":0.12,"flagged_group_count":0,"interpretation":"aggregate_descriptive_metrics_not_a_fairness_or_legal_conclusion","method":"group selection-rate difference and ratio audit"}}