Skip to main content
GET
/
v2
/
failure-analysis
/
taxonomy
/
subcategories
List subcategories
curl --request GET \
  --url https://api.valiqor.com/v2/failure-analysis/taxonomy/subcategories \
  --header 'Authorization: Bearer <token>'
[
  {
    "subcategory_id": "<string>",
    "subcategory_name": "<string>",
    "description": "<string>",
    "detection_approach": "<string>",
    "applies_to": [
      "<string>"
    ],
    "requires_retrieval": false,
    "requires_tools": false,
    "minimal_mode_compatible": false,
    "required_inputs": [
      "<string>"
    ],
    "related_eval_metrics": [
      "<string>"
    ],
    "related_security_categories": [
      "<string>"
    ],
    "impact_score": 1,
    "risk_category": "medium"
  }
]

Authorizations

​
Authorization
string
header
required

Valiqor API key. Pass as Bearer token: Authorization: Bearer vq-xxxxxxxxxxxxxxxxxxxx

Query Parameters

​
bucket_id
string | null

Filter by bucket ID

​
minimal_mode_only
boolean
default:false

Only show minimal-mode compatible subcategories

​
requires_retrieval
boolean | null

Filter by retrieval requirement

​
requires_tools
boolean | null

Filter by tools requirement

Response

Successful Response

​
subcategory_id
string
required
​
subcategory_name
string
required
​
description
string
required
​
detection_approach
string
required

'deterministic', 'llm_judge', or 'hybrid'

​
applies_to
string[]

Applicable app types

​
requires_retrieval
boolean
default:false
​
requires_tools
boolean
default:false
​
minimal_mode_compatible
boolean
default:false
​
required_inputs
string[]

Required input types for this detector

​
related_eval_metrics
string[]
​
related_security_categories
string[]
​
impact_score
integer
default:1

Impact score 0-3

​
risk_category
string
default:medium

'high', 'medium', or 'low'