app.bsky.actor.getProfiles

GET /xrpc/app.bsky.actor.getProfiles

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.

Get detailed profile views of multiple actors.

Request

Query Parameters

actors at-identifier[]required

Possible values: <= 25

Responses

application/json

Schema
Example (from schema)

Schema

profiles

object[]

required

Array [

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

description string

Possible values: <= 2560 characters

avatar uri

banner uri

followersCount integer

followsCount integer

postsCount integer

associated

object

lists integer

feedgens integer

starterPacks integer

labeler boolean

chat

object

allowIncoming stringrequired

Possible values: [all, none, following]

joinedViaStarterPack

object

uri at-urirequired

cid cidrequired

record required

creator

object

required

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

avatar uri

associated

object

lists integer

feedgens integer

starterPacks integer

labeler boolean

chat

object

allowIncoming stringrequired

Possible values: [all, none, following]

viewer

object

Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.

muted boolean

mutedByList

object

uri at-urirequired

cid cidrequired

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist
app.bsky.graph.defs.referencelist

string

avatar uri

listItemCount integer

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

viewer

object

muted boolean

blocked at-uri

indexedAt date-time

blockedBy boolean

blocking at-uri

blockingByList

object

uri at-urirequired

cid cidrequired

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist
app.bsky.graph.defs.referencelist

string

avatar uri

listItemCount integer

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

viewer

object

muted boolean

blocked at-uri

indexedAt date-time

following at-uri

followedBy at-uri

knownFollowers

object

The subject's followers whom you also follow

count integerrequired

followers undefined[]required

Possible values: <= 5

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

createdAt date-time

listItemCount integer

joinedWeekCount integer

joinedAllTimeCount integer

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

indexedAt date-timerequired

indexedAt date-time

createdAt date-time

viewer

object

Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.

muted boolean

mutedByList

object

uri at-urirequired

cid cidrequired

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist
app.bsky.graph.defs.referencelist

string

avatar uri

listItemCount integer

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

viewer

object

muted boolean

blocked at-uri

indexedAt date-time

blockedBy boolean

blocking at-uri

blockingByList

object

uri at-urirequired

cid cidrequired

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist
app.bsky.graph.defs.referencelist

string

avatar uri

listItemCount integer

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

viewer

object

muted boolean

blocked at-uri

indexedAt date-time

following at-uri

followedBy at-uri

knownFollowers

object

The subject's followers whom you also follow

count integerrequired

followers

object[]

required

Possible values: < 5

Array [

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

avatar uri

associated

object

lists integer

feedgens integer

starterPacks integer

labeler boolean

chat

object

allowIncoming stringrequired

Possible values: [all, none, following]

viewer

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

createdAt date-time

]

labels

object[]

Array [

ver integer

src didrequired

DID of the actor who created this label.

uri urirequired

AT URI of the record, repository (account), or other resource that this label applies to.

cid cid

Optionally, CID specifying the specific version of 'uri' resource this label applies to.

val stringrequired

Possible values: <= 128 characters

The short string name of the value or type of this label.

neg boolean

If true, this is a negation label, overwriting a previous label.

cts date-timerequired

Timestamp when this label was created.

exp date-time

Timestamp at which this label expires (no longer applies).

sig byte

Signature of dag-cbor encoded label.

]

pinnedPost

object

uri at-urirequired

cid cidrequired

]

{
  "profiles": [
    {
      "did": "string",
      "handle": "string",
      "displayName": "string",
      "description": "string",
      "avatar": "string",
      "banner": "string",
      "followersCount": 0,
      "followsCount": 0,
      "postsCount": 0,
      "associated": {
        "lists": 0,
        "feedgens": 0,
        "starterPacks": 0,
        "labeler": true,
        "chat": {
          "allowIncoming": "all"
        }
      },
      "joinedViaStarterPack": {
        "uri": "string",
        "cid": "string",
        "record": {},
        "creator": {
          "did": "string",
          "handle": "string",
          "displayName": "string",
          "avatar": "string",
          "associated": {
            "lists": 0,
            "feedgens": 0,
            "starterPacks": 0,
            "labeler": true,
            "chat": {
              "allowIncoming": "all"
            }
          },
          "viewer": {
            "muted": true,
            "mutedByList": {
              "uri": "string",
              "cid": "string",
              "name": "string",
              "purpose": "string",
              "avatar": "string",
              "listItemCount": 0,
              "labels": [
                {
                  "ver": 0,
                  "src": "string",
                  "uri": "string",
                  "cid": "string",
                  "val": "string",
                  "neg": true,
                  "cts": "2024-11-07T00:27:25.311Z",
                  "exp": "2024-11-07T00:27:25.311Z",
                  "sig": "string"
                }
              ],
              "viewer": {
                "muted": true,
                "blocked": "string"
              },
              "indexedAt": "2024-11-07T00:27:25.311Z"
            },
            "blockedBy": true,
            "blocking": "string",
            "blockingByList": {
              "uri": "string",
              "cid": "string",
              "name": "string",
              "purpose": "string",
              "avatar": "string",
              "listItemCount": 0,
              "labels": [
                {
                  "ver": 0,
                  "src": "string",
                  "uri": "string",
                  "cid": "string",
                  "val": "string",
                  "neg": true,
                  "cts": "2024-11-07T00:27:25.312Z",
                  "exp": "2024-11-07T00:27:25.312Z",
                  "sig": "string"
                }
              ],
              "viewer": {
                "muted": true,
                "blocked": "string"
              },
              "indexedAt": "2024-11-07T00:27:25.312Z"
            },
            "following": "string",
            "followedBy": "string",
            "knownFollowers": {
              "count": 0,
              "followers": [
                null
              ]
            }
          },
          "labels": [
            {
              "ver": 0,
              "src": "string",
              "uri": "string",
              "cid": "string",
              "val": "string",
              "neg": true,
              "cts": "2024-11-07T00:27:25.312Z",
              "exp": "2024-11-07T00:27:25.312Z",
              "sig": "string"
            }
          ],
          "createdAt": "2024-11-07T00:27:25.312Z"
        },
        "listItemCount": 0,
        "joinedWeekCount": 0,
        "joinedAllTimeCount": 0,
        "labels": [
          {
            "ver": 0,
            "src": "string",
            "uri": "string",
            "cid": "string",
            "val": "string",
            "neg": true,
            "cts": "2024-11-07T00:27:25.312Z",
            "exp": "2024-11-07T00:27:25.312Z",
            "sig": "string"
          }
        ],
        "indexedAt": "2024-11-07T00:27:25.312Z"
      },
      "indexedAt": "2024-11-07T00:27:25.312Z",
      "createdAt": "2024-11-07T00:27:25.312Z",
      "viewer": {
        "muted": true,
        "mutedByList": {
          "uri": "string",
          "cid": "string",
          "name": "string",
          "purpose": "string",
          "avatar": "string",
          "listItemCount": 0,
          "labels": [
            {
              "ver": 0,
              "src": "string",
              "uri": "string",
              "cid": "string",
              "val": "string",
              "neg": true,
              "cts": "2024-11-07T00:27:25.312Z",
              "exp": "2024-11-07T00:27:25.312Z",
              "sig": "string"
            }
          ],
          "viewer": {
            "muted": true,
            "blocked": "string"
          },
          "indexedAt": "2024-11-07T00:27:25.312Z"
        },
        "blockedBy": true,
        "blocking": "string",
        "blockingByList": {
          "uri": "string",
          "cid": "string",
          "name": "string",
          "purpose": "string",
          "avatar": "string",
          "listItemCount": 0,
          "labels": [
            {
              "ver": 0,
              "src": "string",
              "uri": "string",
              "cid": "string",
              "val": "string",
              "neg": true,
              "cts": "2024-11-07T00:27:25.312Z",
              "exp": "2024-11-07T00:27:25.312Z",
              "sig": "string"
            }
          ],
          "viewer": {
            "muted": true,
            "blocked": "string"
          },
          "indexedAt": "2024-11-07T00:27:25.312Z"
        },
        "following": "string",
        "followedBy": "string",
        "knownFollowers": {
          "count": 0,
          "followers": [
            {
              "did": "string",
              "handle": "string",
              "displayName": "string",
              "avatar": "string",
              "associated": {
                "lists": 0,
                "feedgens": 0,
                "starterPacks": 0,
                "labeler": true,
                "chat": {
                  "allowIncoming": "all"
                }
              },
              "labels": [
                {
                  "ver": 0,
                  "src": "string",
                  "uri": "string",
                  "cid": "string",
                  "val": "string",
                  "neg": true,
                  "cts": "2024-11-07T00:27:25.313Z",
                  "exp": "2024-11-07T00:27:25.313Z",
                  "sig": "string"
                }
              ],
              "createdAt": "2024-11-07T00:27:25.313Z"
            }
          ]
        }
      },
      "labels": [
        {
          "ver": 0,
          "src": "string",
          "uri": "string",
          "cid": "string",
          "val": "string",
          "neg": true,
          "cts": "2024-11-07T00:27:25.313Z",
          "exp": "2024-11-07T00:27:25.313Z",
          "sig": "string"
        }
      ],
      "pinnedPost": {
        "uri": "string",
        "cid": "string"
      }
    }
  ]
}

Bad Request

application/json

Schema
Example (from schema)

Schema

error stringrequired

Possible values: [InvalidRequest, ExpiredToken, InvalidToken]

message stringrequired

{
  "error": "InvalidRequest",
  "message": "string"
}

Unauthorized

application/json

Schema
Example (from schema)

Schema

error required

message stringrequired

{
  "message": "string"
}

app.bsky.actor.getProfiles

/xrpc/app.bsky.actor.getProfiles

Request​

Query Parameters

Responses​

Request

Responses