Get all skills in the taxonomy

The /taxonomy endpoint is a REST service offered via a GET method.
It returns all skills in the taxonomy with their ID and descriptions in all supported languages.

Remember to send your authentication token with each request (see Authentication page).

Endpoint

Method	Media	URL	Description
GET	query string	{{domain}}/taxonomy	Get the code ids and their description in all languages

Response

Status	Content type	Content description
200 (OK)	application/json	A JSON object containing: codes: an array of skill objects version: the API version meta: an object including the taxonomy version (release date)

Example

$ curl -sSf -X GET https://api.textkernel.nl/skills/v3/taxonomy \
    -H "Authorization: Bearer $TOKEN" -H "Accept-encoding: gzip" | gzip -d

{
  "codes": [
    {
      "category": "Language",
      "code_id": "KS123K75YYK8VGH90NCS",
      "definitions": {
        "en": "English is the skill of proficiently reading, writing, and speaking the English language. It encompasses a strong understanding of grammar, vocabulary, and pronunciation, enabling effective communication in various contexts. English proficiency is essential in many professions, such as teaching, where educators must convey complex ideas clearly, and in roles requiring collaboration and interaction, such as event management and customer service."
      },
      "descriptions": {
        "de": "Englisch",
        "en": "English",
        "es": "Inglés",
        "fr": "Anglais",
        "it": "Inglese",
        "nl": "Engels",
        ...
      },
      "iso_code": "en"
    },
    ...
  ],
  "meta": [
    {
      "concept_type": "skills",
      "language": "EN",
      "purpose": "normalization",
      "release_datetime": "2025-03-20T12:35:33.559973"
    },
    ...
  ],
  "version": "3.5.1"
}

Response fields

Field	Type	Value
code_id	str	The code id of the normalized skill from the Taxonomy (unique across all languages)
category	str	The category of the extracted skill. See the Overview for the list of supported categories.
definitions	object	The skill definitions (only in English language)
descriptions	object	The normalized skill concept for each language
iso_code	str	The language ISO 639-1 code (only for language skills)

Rate limits

Accounts have a limited request rate. If you exceed the limit you will receive 429 Too Many Requests HTTP responses.

Plan	Limit	Units
Standard	10	Hour
Demo	0	Hour