---
title: "List published paths"
method: GET
path: "/v2/published-paths/"
tags: ["Published Paths"]
---

# List published paths

`GET /v2/published-paths/`

## Request

- Base URL: `https://api.skilljar.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.skilljar.com/v2/published-paths/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/skilljar/apis/skilljar-api-v2/docs/v2/published-paths/get.ts> (a function with typed inputs; its response is checked against the schema)

List the organization's published paths.

**Required OAuth scope:** `paths:read`

## Query parameters

- `page[size]` integer: Maximum number of records to return. Values above 100 are served as 100; values below 1 are served as 1.
- `page[cursor]` string, nullable: Opaque cursor from the previous page's links.next.
- `filter[domain.id]` string, nullable: Opaque domain id.
- `filter[path.id]` string, nullable: Opaque path id.
- `filter[is_hidden]` boolean, nullable: Match the hidden flag.
- `filter[slug]` string, nullable: Exact slug match.
- `include` string, nullable: Related resources to include. Supported: path.

## Response `200`

OK

- PublishedPathListResponse: Paginated list of published paths.
  - `data` PublishedPathResource[], required: The resources on this page, in cursor order.
    - `type` string: Always "published-paths".
    - `id` string, required: Opaque published-path id.
    - `attributes` PublishedPathAttributes, required: Attributes of a published-path resource object.
      - `external_id` string, required
      - `slug` string, required
      - `public_url` string, required
      - `is_hidden` boolean, required
      - `strict_enforce_group_visibility` boolean, required
      - `visibility_override_type` string, required
      - `catalog_layout` string, required
      - `search_location` string, required
      - `search_behavior` string, required
      - `unique_progress_per_enrollment` boolean, required
      - `enforce_sequential_navigation` boolean, required
      - `registration_status` string, required: OPEN or CLOSED (Offer.active).
      - `price_cents` integer, required
      - `price_credits` integer, required
      - `currency_code` string, required
      - `max_quantity` integer, required
      - `sku` string, required
      - `timezone` string, required
      - `expires_at_duration` integer, nullable, required
      - `expires_at_duration_unit` string, required
      - `created_at` string, date-time, required
      - `modified_at` string, date-time, required: Latest update to the published path or any path item.
    - `relationships` object, nullable
    - `links` object, nullable
  - `meta` object, nullable: Pagination metadata, e.g. {"page_size": 25}.
  - `links` PaginationLinks: JSON:API §Links object for a paginated collection. Typed rather than a free-form ``dict`` so ``next`` reaches the generated OpenAPI/SDK/MCP contract. Since GE-256227 removed the top-level ``next_cursor``, ``links.next`` is the only pagination affordance a machine consumer has — an untyped ``dict`` would leave it undiscoverable.
    - `self` string, nullable: Path of the current request, relative and without its query string (so every page of a filtered collection reports the same value).
    - `next` string, nullable: Relative path of the next page, ready to request as-is. Carries ``page[cursor]`` plus every non-cursor query param from the current request (``page[size]``, ``filter[*]``, ``include``). Null on the last page.
    - `prev` string, nullable: Relative path of the previous page. Not implemented — currently always null.
  - `included` object[], nullable: Related resources requested via ?include=. Absent when no include was requested.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `406`: Not Acceptable: Accept rules out application/vnd.api+json.
- `422`: Unprocessable Entity

## Changes

- **2026-10-21** `16a566965a72`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skilljar/apis/skilljar-api-v2/changes/v2/published-paths/get.md)

---

[API](https://skmtc.dev/skilljar/apis/skilljar-api-v2.md) - [All operations](https://skmtc.dev/skilljar/apis/skilljar-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/skilljar/apis/skilljar-api-v2/revisions/fbda30ce1742?raw)