> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twixb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Newsfeeds

> Get all newsfeeds for the authenticated user.

# List Newsfeeds

<div className="method-badge get">GET</div> `/v1/newsfeeds`

Returns all newsfeeds owned by or shared with the authenticated user.

## Request

No parameters required.

```bash theme={null}
curl https://twixb.com/api/v1/newsfeeds \
  -H "X-API-Key: twxb_your_key_here"
```

## Response

```json theme={null}
[
  {
    "id": "28b37688-8549-446b-a2f2-9fb49ed51ae7",
    "user_id": "ff670e33-6e73-4845-8585-80a0c8920517",
    "name": "AI Research",
    "description": "Latest AI papers and news",
    "keywords": ["LLM", "transformer", "machine learning"],
    "start_date": "2026-01-09",
    "business_context": null,
    "digest_frequency": "weekly",
    "created_at": "2026-02-08T20:16:42.060322",
    "updated_at": "2026-02-09T09:24:10.421330",
    "source_count": 3,
    "unread_count": 42,
    "role": "owner"
  }
]
```

## Response fields

| Field              | Type          | Description                                  |
| ------------------ | ------------- | -------------------------------------------- |
| `id`               | string (UUID) | Newsfeed ID                                  |
| `name`             | string        | Newsfeed name                                |
| `description`      | string        | Optional description                         |
| `keywords`         | string\[]     | Keywords used to filter incoming posts       |
| `start_date`       | string        | Only posts after this date are included      |
| `business_context` | string        | Context used to personalize AI key learnings |
| `digest_frequency` | string        | Email digest frequency (`daily` or `weekly`) |
| `source_count`     | integer       | Number of sources in this newsfeed           |
| `unread_count`     | integer       | Number of unread posts                       |
| `role`             | string        | Your role (`owner` or `editor`)              |