Mapademics Skills Library

Browse and search the Mapademics Skills Library (MSL) containing 585 skills organized into 33 domains.

List skills

get

Returns a paginated list of skills from the Mapademics Skills Library (MSL). Use query parameters to filter and paginate results.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Query parameters

domainIdstringOptional

Filter skills by domain ID

Example: msl_dom_8

limitinteger · min: 1 · max: 100Optional

Maximum number of skills to return (1-100)

Default: 25

offsetintegerOptional

Number of skills to skip for pagination

Default: 0

Responses

200

List of skills

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills-library/skills

HTTPcURLJavaScriptPython

GET /v1/skills-library/skills HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "msl_skill_0001",
      "version": "1.0",
      "domainId": "msl_dom_1",
      "name": "Accounting",
      "description": "Apply accounting principles to analyze financial information and prepare reports.",
      "exampleTasks": [
        "Prepare financial statements",
        "Analyze budget variances",
        "Record journal entries"
      ]
    }
  ],
  "meta": {
    "requestId": "req_abc123def",
    "timestamp": "2025-01-30T12:00:00Z"
  },
  "pagination": {
    "total": 585,
    "limit": 25,
    "offset": 0,
    "hasMore": true
  }
}

Get a skill

get

Returns detailed information about a specific skill by ID.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Path parameters

skillIdstringRequired

The skill ID (e.g., msl_skill_0001)

Example: msl_skill_0127

Responses

200

Skill details

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

404

Resource not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills-library/skills/{skillId}

HTTPcURLJavaScriptPython

GET /v1/skills-library/skills/{skillId} HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "skill",
  "data": {
    "id": "msl_skill_0127",
    "version": "1.0",
    "domainId": "msl_dom_15",
    "name": "Software Development",
    "description": "Design, code, test, and maintain software applications using programming languages and development frameworks.",
    "exampleTasks": [
      "Write clean, maintainable code",
      "Debug and fix software issues",
      "Implement new features from requirements",
      "Conduct code reviews"
    ],
    "domain": {
      "id": "msl_dom_15",
      "name": "Information Technology",
      "version": "1.0"
    }
  },
  "meta": {
    "requestId": "req_def456ghi",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Search skills

get

Full-text search across skill names, descriptions, and example tasks. Returns skills ranked by relevance to the search query.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Query parameters

qstring · min: 2Required

Search query string

Example: data analysis

limitinteger · min: 1 · max: 50Optional

Maximum number of results (1-50)

Default: 10

Responses

200

Search results

application/json

400

Invalid request parameters

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills-library/skills/search

HTTPcURLJavaScriptPython

GET /v1/skills-library/skills/search?q=text HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "msl_skill_0089",
      "version": "1.0",
      "domainId": "msl_dom_8",
      "name": "Data Analysis",
      "description": "Collect, process, and analyze data to identify patterns and insights.",
      "exampleTasks": [
        "Analyze datasets using statistical methods",
        "Create visualizations to communicate findings"
      ],
      "relevanceScore": 0.98
    },
    {
      "id": "msl_skill_0091",
      "version": "1.0",
      "domainId": "msl_dom_8",
      "name": "Statistical Analysis",
      "description": "Apply statistical methods to analyze and interpret data.",
      "exampleTasks": [
        "Perform hypothesis testing",
        "Build regression models"
      ],
      "relevanceScore": 0.85
    }
  ],
  "meta": {
    "requestId": "req_ghi789jkl",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

List all domains

get

Returns all skill domains in the Mapademics Skills Library.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Responses

200

List of domains

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills-library/domains

HTTPcURLJavaScriptPython

GET /v1/skills-library/domains HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "msl_dom_1",
      "name": "Finance & Accounting",
      "version": "1.0",
      "skillCount": 24
    },
    {
      "id": "msl_dom_8",
      "name": "Data & Analytics",
      "version": "1.0",
      "skillCount": 18
    },
    {
      "id": "msl_dom_15",
      "name": "Information Technology",
      "version": "1.0",
      "skillCount": 32
    }
  ],
  "meta": {
    "requestId": "req_jkl012mno",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Get a domain with its skills

get

Returns a domain and all skills within that domain.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Path parameters

domainIdstringRequired

The domain ID (e.g., msl_dom_15)

Example: msl_dom_15

Responses

200

Domain with skills

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

404

Resource not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills-library/domains/{domainId}

HTTPcURLJavaScriptPython

GET /v1/skills-library/domains/{domainId} HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "text",
  "data": {
    "id": "msl_dom_15",
    "name": "Information Technology",
    "version": "1.0",
    "skillCount": 32,
    "skills": [
      {
        "id": "msl_skill_0127",
        "version": "1.0",
        "domainId": "msl_dom_15",
        "name": "Software Development",
        "description": "Design, code, test, and maintain software applications.",
        "exampleTasks": [
          "Write clean, maintainable code",
          "Debug and fix software issues"
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123xyz",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Get complete skill tree

get

Returns the complete skills taxonomy organized by domain. Useful for building skill pickers or displaying the full hierarchy.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Responses

200

Complete skill tree

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills-library/tree

HTTPcURLJavaScriptPython

GET /v1/skills-library/tree HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "text",
  "data": {
    "version": "1.0",
    "totalDomains": 33,
    "totalSkills": 585,
    "domains": [
      {
        "id": "msl_dom_15",
        "name": "Information Technology",
        "version": "1.0",
        "skillCount": 32,
        "skills": [
          {
            "id": "msl_skill_0127",
            "version": "1.0",
            "domainId": "msl_dom_15",
            "name": "Software Development",
            "description": "Design, code, test, and maintain software applications.",
            "exampleTasks": [
              "Write clean, maintainable code",
              "Debug and fix software issues"
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123xyz",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}