---
title: "List Hero Stories"
method: GET
path: "/api/public/v1/hero-stories"
tags: ["Community"]
---

# List Hero Stories

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

## Request

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

READ. Returns the published Hero Story testimonials shown on the website.

## Query parameters

- `limit` integer

## Response `200`

A list of Hero Stories.

- HeroStoryList: A collection of published Hero Stories.
  - `total` integer, required: Items matching the filters.
  - `count` integer, required: Items returned in this response.
  - `items` HeroStory[], required: The HeroStory records returned by this request.
    - `quote` string, required: Testimonial text.
    - `name` string, required: Display name as published.
    - `role` string, required: Role or path the person follows.

## 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)