---
title: "View all Skill Frameworks"
method: GET
path: "/v1/skill_frameworks"
tags: ["Skills Frameworks"]
---

# View all Skill Frameworks

`GET /v1/skill_frameworks`

Lists the Skill Frameworks enabled for a Department, each with its published versions.

This is the starting point for tagging a Group with framework skills. Pick a framework, take the `id` of the version you want from its `versions` array, then use that value as `skill_framework_version_id` when you create or update a Group.

Only frameworks enabled for the requested Department are returned, so the response is exactly the set you are allowed to attach to Groups in that Department. Frameworks that an administrator has added but not yet enabled are not listed.

When Accredible retires an external framework for your Department, it stays listed throughout the notice period so your integration is not broken by an abrupt removal. Its version is reported with `status` `retired` and a `valid_to` date telling you when it stops working.

## Query parameters

- `department_id` integer, required
- `page` integer
- `page_size` integer

## Response `200`

OK

- object
  - `skill_frameworks` object[]
    - `id` number, required — Unique identifier of the Skill Framework.
    - `name` string, required — Display name of the framework, for example `O*NET Skills`.
    - `source_type` 'external' | 'custom', required — `external` for a framework maintained by Accredible, `custom` for one uploaded by your organization.
    - `taxonomy` string, nullable, required — The published taxonomy an external framework comes from: `ONET`, `ESCO` or `NACE`. Always `null` for custom frameworks.
    - `status` 'enabled', required — Always `enabled` — only frameworks enabled for the requested Department are returned. Version retirement is reported per version inside `versions`, not here.
    - `provider` string, nullable, required — The organization that publishes the framework, for example `U.S. Department of Labor`.
    - `description` string, nullable, required
    - `skill_count` number, nullable, required — Number of skills in the framework's latest active version.
    - `updated_at` string, required
    - `attribution` object, required — Attribution that the framework's licence requires you to display wherever you show its skills.
      - `text` string, nullable
      - `url` string, nullable
    - `versions` object[], required — Published versions of the framework, oldest first. Only `active` and `retired` versions are returned — versions still being prepared are never exposed. Use a version's `id` as the `skill_framework_version_id` when creating or updating a Group.
      - `id` number, required — Pass this value as `skill_framework_version_id` on a Group.
      - `version` string, required — The publisher's version label, for example `30.0`.
      - `skill_count` number, required
      - `status` 'active' | 'retired', required — Skills can only be attached to a Group from an `active` version. Attempting to use a `retired` version returns a `207` with a `version_retired` error.
      - `valid_from` string, date, nullable, required
      - `valid_to` string, date, nullable, required — The date this version stops being usable. `null` for a version with no end date.
  - `meta` object
    - `current_page` number
    - `next_page` number, nullable
    - `prev_page` number, nullable
    - `total_pages` number
    - `total_count` number
    - `page_size` number

## Other responses

- `400` — Bad Request - `missing_department_id` when the required `department_id` parameter is not supplied.
- `403` — Forbidden - `plan_not_entitled` when your plan does not include skills frameworks, or `invalid_department` when the given `department_id` is not a Department your API key can access.

---

[API](https://skmtc.net/accredible/apis/accredible-credential-api.md) · [All operations](https://skmtc.net/accredible/apis/accredible-credential-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/accredible/accredible-credential-api/versions/56b317c13686/schema)