app.bsky.feed.getListFeed

bsky-lexicons.bsky.social

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.",
      "errors": [
        {
          "name": "UnknownList"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "type": "string"
            },
            "feed": {
              "items": {
                "ref": "app.bsky.feed.defs#feedViewPost",
                "type": "ref"
              },
              "type": "array"
            },
            "startCursor": {
              "description": "Cursor identifying the newest item in this page. Pass it as since on a later request to fetch only newer content.",
              "type": "string"
            }
          },
          "required": [
            "feed"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "type": "string"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "list": {
            "description": "Reference (AT-URI) to the list record.",
            "format": "at-uri",
            "type": "string"
          },
          "since": {
            "description": "Return only items newer than the position identified by this cursor value, newest first. Use the startCursor from a previous response. The item at that position is not returned because the caller already holds it. When the bounded range is exhausted, the returned cursor equals this value so that pagination continues below the boundary.",
            "type": "string"
          }
        },
        "required": [
          "list"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "app.bsky.feed.getListFeed",
  "lexicon": 1
}

Validate Record

Validate a record against app.bsky.feed.getListFeed

Validation Options
Automatically resolve and include external schemas for full validation
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:4v4y5r3lwsbtmsxhile2ljac
CID
bafyreiahsqknrua2kkmdyzmckadfqap5wuwx645nvwtceibr6dqstfzvaa
Indexed At
2026-09-25 16:54 UTC
AT-URI
at://did:plc:4v4y5r3lwsbtmsxhile2ljac/com.atproto.lexicon.schema/app.bsky.feed.getListFeed

Version History (2 versions)

Referenced Schemas (1)

Similar Lexicons

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • town.delve.feed.getListFeed querynot from the namespace authority

    Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.

  • Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.

  • Get a hydrated feed from an actor's selected feed generator. Implemented by App View.

  • Chronological article feed across all publications in a list.

  • Get a feed of posts. Use the 'feed' parameter to select which feed: 'following' for posts from followed accounts, 'global' for all posts, or an at-uri for a custom feed generator.

Lexicon Garden

@