app.bsky.graph.get Lists

GET {{baseUrl}}/xrpc/app.bsky.graph.getLists?actor=<at-identifier>&limit=50&cursor=<string>

This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.`). Public endpoints which don't require authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated requests are usually made to the user's PDS, with automatic service proxying. Authenticated requests can be used for both public and non-public endpoints.*

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

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

Request Params

HEADERS

RESPONSES

status: OK

{"lists":[{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","creator":{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","description":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"indexedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","viewer":{"muted":"\u003cboolean\u003e","mutedByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"blockedBy":"\u003cboolean\u003e","blocking":"\u003cat-uri\u003e","blockingByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"following":"\u003cat-uri\u003e","followedBy":"\u003cat-uri\u003e","knownFollowers":{"count":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"followers":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]},"name":"\u003cstring\u003e","purpose":"\u003ctoken\u003e","indexedAt":"\u003cdateTime\u003e","description":"\u003cstring\u003e","descriptionFacets":[{"index":{"byteStart":"\u003cinteger\u003e","byteEnd":"\u003cinteger\u003e"},"features":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]},{"index":{"byteStart":"\u003cinteger\u003e","byteEnd":"\u003cinteger\u003e"},"features":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]}],"avatar":"\u003curi\u003e","listItemCount":"\u003cinteger\u003e","labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}],"viewer":{"muted":"\u003cboolean\u003e","blocked":"\u003cat-uri\u003e"}},{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","creator":{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","description":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"indexedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","viewer":{"muted":"\u003cboolean\u003e","mutedByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"blockedBy":"\u003cboolean\u003e","blocking":"\u003cat-uri\u003e","blockingByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"following":"\u003cat-uri\u003e","followedBy":"\u003cat-uri\u003e","knownFollowers":{"count":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"followers":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]},"name":"\u003cstring\u003e","purpose":"\u003ctoken\u003e","indexedAt":"\u003cdateTime\u003e","description":"\u003cstring\u003e","descriptionFacets":[{"index":{"byteStart":"\u003cinteger\u003e","byteEnd":"\u003cinteger\u003e"},"features":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]},{"index":{"byteStart":"\u003cinteger\u003e","byteEnd":"\u003cinteger\u003e"},"features":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]}],"avatar":"\u003curi\u003e","listItemCount":"\u003cinteger\u003e","labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}],"viewer":{"muted":"\u003cboolean\u003e","blocked":"\u003cat-uri\u003e"}}],"cursor":"\u003cstring\u003e"}