---
title: "List articles for a specific folder"
method: GET
path: "/api/v1/articles/by-folder/{folderId}"
tags: ["Articles"]
---

# List articles for a specific folder

`GET /api/v1/articles/by-folder/{folderId}`

## Request

- Base URL: `https://feednest.com`
- URL: `https://feednest.com/api/v1/articles/by-folder/{folderId}`
- Auth: HTTP bearer

Returns articles from every feed inside one folder, newest first. `folderId` comes from `GET /api/v1/folders`. Uses the same keyset pagination as the newsfeed. Requires the `read` scope.

## Path parameters

- `folderId` string, uuid, required

## Query parameters

- `limit` integer
- `before_published_at` string, date-time
- `before_id` string, uuid
- `unread_only` 'true' | 'false'
- `count_only` 'true' | 'false'
- `q` string
- `date_from` string, date
- `date_to` string, date
- `sort` 'newest' | 'oldest'

## Response `200`

Paginated article list

- object
  - `data` ArticleV1[], required
    - `id` string, uuid, required
    - `title` string, nullable, required
    - `source` string, nullable, required
    - `url` string, uri, required
    - `published_at` string, date-time, nullable, required
    - `summary_preview` string, nullable, required
    - `image_url` string, uri, nullable, required
    - `is_read` boolean, required
    - `is_saved` boolean, required
    - `tags` string[], required
    - `highlights_count` integer, required
    - `notes_count` integer, required
  - `meta` object, required
    - `has_more` boolean, required

## Other responses

- `401`: Missing or invalid API key
- `403`: Insufficient permissions or subscription required
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/feednest/apis/feednest-public-api.md) · [All operations](https://skmtc.dev/feednest/apis/feednest-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feednest/apis/feednest-public-api/revisions/51c8242d8418?raw)