Skip to main content
GET
/
v1
/
skills
List Skills
curl --request GET \
  --url https://api.mokaru.ai/v1/skills \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "category": "<string>",
      "level": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "total": 123,
  "hasMore": true,
  "limit": 123,
  "offset": 123
}

​
Overview

The List Skills endpoint returns all skills in your Mokaru account. Use this to review your skill inventory or sync with external tools. Common use cases:
  • AI agent skill matching - let your AI agent compare your skills against job requirements.
  • Resume optimization - identify which skills to highlight for a specific role.
  • Skill gap analysis - export skills to analyze gaps against target job descriptions.
Scope required: skills:read | Rate limit: 60 requests/min

​
Request

GET /v1/skills

​
Query Parameters

​
limit
number
default:"25"
Results per page (max 100)
​
offset
number
default:"0"
Number of results to skip for pagination

​
Example

curl "https://api.mokaru.ai/v1/skills?limit=50" \
  -H "Authorization: Bearer mk_your_key"

​
Response

​
data
array
Array of skills
​
total
number
Total number of skills
​
hasMore
boolean
Whether more pages are available
​
limit
number
Current page size
​
offset
number
Current offset
{
  "data": [
    {
      "id": "clx1234...",
      "name": "TypeScript",
      "category": "Frontend",
      "level": "expert",
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-03-15T14:30:00.000Z"
    },
    {
      "id": "clx5678...",
      "name": "React",
      "category": "Frontend",
      "level": "advanced",
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-03-15T14:30:00.000Z"
    }
  ],
  "total": 12,
  "hasMore": false,
  "limit": 50,
  "offset": 0
}