Normalize a skill

GET /normalize/skill

Raw skill → canonical taxonomy entry with aliases. Skills outside the seed taxonomy return taxonomy_id: null with the input as canonical.

Cost: free.

Query parameters

Example request

curl "https://api.rezmatch.ai/normalize/skill?skill=k8s" \
  -H "x-access-key: $TALENTKIT_API_KEY"

Example response

{
  "success": true,
  "data": {
    "canonical": "Kubernetes",
    "taxonomy_id": "skill_kubernetes",
    "aliases": [
      "k8s"
    ]
  },
  "credits_used": 0,
  "request_id": "req_00d542ff-427b-409b-a377-c913ff60fdfb"
}

Errors

All errors share the error envelope.

Try it

Open this endpoint in the interactive playground  — requests run with your API key.