List curation feeds

GET

/api/v3/curations/feeds

curl --request GET \
  --url 'https://api.tryletterhead.com/api/v3/curations/feeds?api=true&status=active&direction=asc' \
  --header 'Authorization: Bearer <token>'

• Production

Returns a paginated list of the company’s RSS feeds — the feeds that automatically crawl for new curations, shared across one or more channels. For JSON data feeds, see List data feeds.

Query parameters

• keyword, limit (default 25), page (default 1).
• status — active, inactive, or error.
• channels[] — filter to feeds shared with any of these channel slugs.
• orderBy — one of title, status, validationCode, channelName, createdAt, updatedAt, lastValidated (default createdAt).
• direction — asc or desc (default desc).
• companyOnly — restrict to feeds created at the company level (excludes legacy per-channel feeds).

Authorizations

• bearerAuth

Parameters

Query Parameters

api

required

boolean

Required. Set to true to authenticate with your company API key rather than a signed-in session.

keyword

string

status

string

Allowed values: active inactive error

limit

integer

page

integer

channels[]

Array<string>

orderBy

string

direction

string

Allowed values: asc desc

companyOnly

boolean

Responses

200

200 OK

Media type application/json

object

items

Array<object>

The shape returned for both RSS feeds (List curation feeds) and JSON data feeds (List data feeds) — type (0 RSS, 1 JSON data feed) tells the two apart. fieldMappings, authType, and hasAuthSecret are only meaningful on a JSON data feed.

object

uniqueId

string

title

string

description

string

feedUrl

string

type

0 RSS feed, 1 JSON data feed.

integer

isValid

boolean

validationCode

integer

nullable

crawl

boolean

archiveIntervalDays

integer

lastValidated

string

lastQueried

string

channelName

The channel this feed was originally created against, or blank for a feed shared to multiple channels with no single owner.

string

channelSlug

string

sharedChannelIds

Internal numeric identifiers of every channel this feed is shared with.

Array<integer>

tags

Array<string>

authType

0 — no authentication. 1 — bearer token.

integer

hasAuthSecret

Whether a credential is stored — the credential itself is never returned.

boolean

fieldMappings

Array<object>

object

source

string

target

string

createdAt

string

updatedAt

string

deletedAt

string

nullable

message

string

total

integer

Example

{
  "items": [
    {
      "uniqueId": "feed_7x2mle",
      "title": "Example Daily",
      "description": "Our syndication partner's RSS feed.",
      "feedUrl": "https://example.com/rss",
      "type": 0,
      "isValid": true,
      "validationCode": 200,
      "crawl": true,
      "archiveIntervalDays": 7,
      "channelName": "The Weekly Brew",
      "channelSlug": "the-weekly-brew",
      "sharedChannelIds": [
        54212
      ],
      "tags": [
        "coffee"
      ],
      "authType": 0,
      "hasAuthSecret": false,
      "fieldMappings": [],
      "createdAt": "2026-04-01T09:00:00+00:00",
      "updatedAt": "2026-08-30T09:05:00+00:00"
    }
  ],
  "message": "Feeds fetched successfully.",
  "total": 1
}