app.bsky.labeler.getServices

GET /xrpc/app.bsky.labeler.getServices

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 information about a list of labeler services.

Request

Query Parameters

dids did[]required

detailed boolean

Responses

application/json

Schema
Example (from schema)

Schema

views

object[]

required

Array [

oneOf

app.bsky.labeler.defs.labelerView
app.bsky.labeler.defs.labelerViewDetailed

uri at-urirequired

cid cidrequired

creator

object

required

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

description string

Possible values: <= 2560 characters

avatar uri

associated

object

lists integer

feedgens integer

starterPacks integer

labeler boolean

chat

object

allowIncoming stringrequired

Possible values: [all, none, following]

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.

]

likeCount integer

viewer

object

like at-uri

indexedAt date-timerequired

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.

]

uri at-urirequired

cid cidrequired

creator

object

required

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

description string

Possible values: <= 2560 characters

avatar uri

associated

object

lists integer

feedgens integer

starterPacks integer

labeler boolean

chat

object

allowIncoming stringrequired

Possible values: [all, none, following]

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.

]

policies

object

required

labelValues com.atproto.label.defs.labelValue[]required

Possible values: [!hide, !no-promote, !warn, !no-unauthenticated, dmca-violation, doxxing, porn, sexual, nudity, nsfl, gore]

labelValueDefinitions

object[]

Array [

identifier stringrequired

Possible values: <= 100 characters

The value of the label being defined. Must only include lowercase ascii and the '-' character ([a-z-]+).

severity stringrequired

Possible values: [inform, alert, none]

How should a client visually convey this label? 'inform' means neutral and informational; 'alert' means negative and warning; 'none' means show nothing.

blurs stringrequired

Possible values: [content, media, none]

What should this label hide in the UI, if applied? 'content' hides all of the target; 'media' hides the images/video/audio; 'none' hides nothing.

defaultSetting string

Possible values: [ignore, warn, hide]

Default value: warn

The default setting for this label.

adultOnly boolean

Does the user need to have adult content enabled in order to configure this label?

locales

object[]

required

Array [

lang languagerequired

The code of the language these strings are written in.

name stringrequired

Possible values: <= 640 characters

A short human-readable name for the label.

description stringrequired

Possible values: <= 100000 characters

A longer description of what the label means and why it might be applied.

]

likeCount integer

viewer

object

like at-uri

indexedAt date-timerequired

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.

]

{
  "views": [
    {},
    {}
  ]
}

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.labeler.getServices

/xrpc/app.bsky.labeler.getServices

Request​

Query Parameters

Responses​

Request

Responses