Backfill in-progress. Some lexicons and records may be missing or incomplete.

app.bsky.graph.getLists

bsky-lexicons.bsky.social

Documentation

main query

Enumerates the lists created by a specified account (actor).

Parameters

actor string at-identifier Required

The account (actor) to enumerate lists from.

cursor string Optional

No description provided.

limit integer Optional

No description provided.

purposes array of string Optional

Optional filter by list purpose. If not specified, all supported types are returned.

Output

Encodingapplication/json
cursor string Optional

No description provided.

lists array Required

No description provided.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
The account (actor) to enumerate lists from.
Optional filter by list purpose. If not specified, all supported types are returned.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "lists"
      ],
      "properties": {
        "lists": {
          "type": "array",
          "items": {
            "ref": "app.bsky.graph.defs#listView",
            "type": "ref"
          }
        },
        "cursor": {
          "type": "string"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor"
    ],
    "properties": {
      "actor": {
        "type": "string",
        "format": "at-identifier",
        "description": "The account (actor) to enumerate lists from."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      },
      "purposes": {
        "type": "array",
        "items": {
          "type": "string",
          "knownValues": [
            "modlist",
            "curatelist"
          ]
        },
        "description": "Optional filter by list purpose. If not specified, all supported types are returned."
      }
    }
  },
  "description": "Enumerates the lists created by a specified account (actor)."
}

Lexicon Garden

@