Pular para o conteúdo principal
GET
Core - List identities by tag
Guia relacionado: guia de Identidades. Consulte o guia de Identidades para um passo a passo com exemplos.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de consulta

limit
integer<int32>
starting_after
string

Cursor for forward pagination. Set to the _id of the last item from the previous page.

ending_before
string

Cursor for backward pagination. Set to the _id of the first item from the previous page.

Case-insensitive search text matched against identity profile fields.

filter_by.tags
string[]

Return only identities that have all of these tags.

include_metrics
boolean

Include aggregate usage metrics on each returned identity.

sort_by
enum<string>

Field used to order the list.

Opções disponíveis:
IDENTITY_SORT_FIELD_DISPLAY_NAME,
IDENTITY_SORT_FIELD_UPDATED
include_budget
boolean

When true, embed each identity's identity-scoped budget (config and limits only, no live usage) on the returned records. Adds one budget lookup for the page; omit to skip it.

Resposta

OK

object
string
obrigatório

Object discriminator for list responses; always list.

data
object[]
obrigatório

Page of identities.

has_more
boolean
obrigatório

Whether more identities are available in the selected pagination direction.