---
title: "List skill definitions"
method: GET
path: "/v1/skill_definitions"
tags: ["Skills"]
---

# List skill definitions

`GET /v1/skill_definitions`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/skill_definitions`
- Auth: HTTP bearer

List skill definitions with advanced filtering.

- `?is_active=is.true` - Only active skills
- `?supports_certification=is.true` - Skills requiring certification
- `?name=ilike.*electric*` - Search by name
- `?select=id,name,description,is_active` - Field selection
- `?order=name.asc` - Alphabetical sorting

## Query parameters

- `select` string
- `order` string
- `limit` integer
- `offset` integer

## Response `200`

Array of skill definitions

- object: Array of skill definitions
  - `data` object[]
    - `id` string, uuid
    - `name` string: Skill name (unique per organisation)
    - `description` string, nullable
    - `category` string, nullable: Deprecated - use skill_categories junction table
    - `supports_proficiency` boolean: Whether this skill supports proficiency levels
    - `supports_certification` boolean: Whether this skill requires certification
    - `is_active` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by_user_id` string, uuid, nullable
  - `meta` object
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `401`: Default Response

---

[API](https://skmtc.dev/workwing/apis/workwing-api.md) · [All operations](https://skmtc.dev/workwing/apis/workwing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workwing/apis/workwing-api/revisions/54bb14368a35?raw)