---
title: "List Articles"
method: GET
path: "/api/v1/newsroom/articles"
tags: ["newsroom"]
---

# List Articles

`GET /api/v1/newsroom/articles`

## Request

- Base URL: `https://mcp.fless.io` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.fless.io/api/v1/newsroom/articles`
- Auth: none declared

List published articles with pagination and optional filtering.

- **page**: Page number (1-indexed)
- **per_page**: Items per page (max 50)
- **category**: Filter by category (product, company, insights, press, partnership, announcement)
- **tag**: Filter by tag

## Query parameters

- `page` integer: Page number
- `per_page` integer: Items per page
- `category` string, nullable: Filter by category
- `tag` string, nullable: Filter by tag

## Response `200`

Successful Response

- ArticleListResponse: Paginated article list response.
  - `articles` ArticleSummary[], required
    - `id` integer, required
    - `slug` string, required
    - `title` string, required
    - `excerpt` string, nullable
    - `featured_image_url` string, nullable
    - `category` string, required
    - `author_name` string, nullable
    - `published_at` string, date-time, nullable
    - `reading_time_minutes` integer, nullable
    - `is_featured` boolean
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fless/apis/apartment-hunting-platform.md) · [All operations](https://skmtc.dev/fless/apis/apartment-hunting-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fless/apis/apartment-hunting-platform/revisions/f542b37a2fcf?raw)