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

impact_score
integer
default:1

Impact score 0-3

risk_category
string
default:medium

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