---
title: "List All Programs Associated with a Subdomain"
method: GET
path: "/programs/{subdomain}"
---

# List All Programs Associated with a Subdomain

`GET /programs/{subdomain}`

Retrieve a list of all the program documents at a given subdomain. You may also filter your results by providing a valid `code` or `categoryId` to only return programs associated with these filter parameters. You may also search against program names with the `search` parameter. Valid query keys are: `categoryId`, `code`, `fields`, `limit`, `search`, and `offset`.

## Query parameters

- `categoryId?` string
- `institutionId?` string
- `institutionRegions?` string
- `code?` string
- `fields?` string
- `search?` string
- `searchFields?` string
- `offset?` integer
- `limit?` integer
- `sort` string

## Response `200`

- ProgramsResponse
  - `data` object[], required
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
      - `application-link` string, required
      - `careers` string[], required
      - `categories` object[], required
        - `name` string, required
        - `slug` string, required
      - `created-at` string, required
      - `credential` string, required
      - `cip` string, required
      - `code` string, required
      - `credits` string, required
      - `institution-id` string, required
      - `length` string, required
      - `length-unit` string, required
      - `locations` string[], required
      - `name` string, required
      - `request-info-email` string, required
      - `transfers` object[], required
        - `name` string, required
        - `url` string, required
      - `tuition-link` string, required
      - `tuition-range` string[], required
      - `updated-at` string, required
      - `url` string, required
      - `slug` string, required
      - `subdomain` string, required
  - `meta` object, required
    - `count` integer, required

## Other responses

- `400`
- `404`

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/versions/fc66b9877391/schema)