---
title: "List Hero Paths"
method: GET
path: "/api/public/v1/hero-paths"
tags: ["Hero Paths"]
---

# List Hero Paths

`GET /api/public/v1/hero-paths`

## Request

- Base URL: `https://www.vaheroesph.com`
- URL: `https://www.vaheroesph.com/api/public/v1/hero-paths`
- Auth: none required

READ. Returns every Hero Path published on the website, optionally filtered by type or featured flag.

## Query parameters

- `type` 'training' | 'sales'
- `featured` boolean
- `limit` integer

## Response `200`

A list of Hero Paths.

- HeroPathList: A filtered collection of Hero Paths.
  - `total` integer, required: Items matching the filters.
  - `count` integer, required: Items returned in this response.
  - `items` HeroPath[], required: The HeroPath records returned by this request.
    - `slug` string, required: URL slug identifying the path.
    - `name` string, required: Display name.
    - `label` string, nullable, required: Short badge label, null when the path has none.
    - `tagline` string, required: One-line summary shown on the path card.
    - `description` string, required: Short description used in listings.
    - `intro` string, required: Longer introduction shown on the path page.
    - `highlights` string[], required: Key learning or role highlights.
    - `type` 'training' | 'sales', required: "training" for VA training paths, "sales" for the Loan Officer career path.
    - `featured` boolean, required: True for the highlighted starter path.
    - `externalUrl` string, uri, nullable, required: External program website, null when none exists.
    - `url` string, uri, required: Canonical page URL on this website.

## Other responses

- `400`: One or more query parameters are invalid.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/vaheroesph/apis/va-heroes-ph-public-content-api.md) · [All operations](https://skmtc.dev/vaheroesph/apis/va-heroes-ph-public-content-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vaheroesph/apis/va-heroes-ph-public-content-api/revisions/65ddf4d10897?raw)