---
title: "List your feed subscriptions."
method: GET
path: "/v1/feeds"
tags: ["Feeds"]
---

# List your feed subscriptions.

`GET /v1/feeds`

## Request

- Base URL: `https://api.inboxy.net`
- URL: `https://api.inboxy.net/v1/feeds`
- Auth: HTTP bearer

## Query parameters

- `status` 'active' | 'error' | 'inactive'

## Response `200`

Feeds.

- object
  - `feeds` Feed[]
    - `id` string, uuid, required: Per-user subscription id. Use this everywhere — the shared feed_sources id is never exposed.
    - `label` string, nullable
    - `url` string, uri, required
    - `title` string, nullable
    - `description` string, nullable
    - `homepage_link` string, nullable
    - `language` string, nullable
    - `status` 'active' | 'error' | 'inactive', required
    - `last_polled_at` integer, nullable: Unix seconds.
    - `last_error` string, nullable
    - `subscribed_at` integer, required
    - `total` integer: Total articles in this feed (across all subscribers).
    - `unread` integer, required: Your unread article count.

---

[API](https://skmtc.dev/inboxy/apis/inboxy-api.md) · [All operations](https://skmtc.dev/inboxy/apis/inboxy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inboxy/apis/inboxy-api/revisions/25155a8dec0f?raw)