> ## Documentation Index > Fetch the complete documentation index at: https://docs.niadra.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar perfis > Os clientes do espaço pela atividade mais recente, com o pseudônimo e os handles mascarados, uma página por vez. ## OpenAPI ````yaml openapi/pt/cell.json GET /v1/profiles openapi: 3.1.0 info: title: API de dados da Niadra version: '1' description: >- Escrita, contexto, histórico, objetos, identidade, privacidade e governança de um espaço. Cada espaço tem um endereço estável, com o espaço e a região no nome. servers: - url: https://{space}.{region}.api.niadra.com variables: space: default: acme-prod description: O espaço, que vem na chave de fonte. region: default: us-east-2 description: A região do espaço, que também vem na chave. security: [] paths: /v1/profiles: get: tags: - identity summary: Listar perfis description: >- Os clientes do espaço pela atividade mais recente, para uma pessoa navegar: pseudônimo, tipo e handles mascarados, nunca um por inteiro. Um perfil apagado não é listado. Uma página pode trazer menos linhas que `limit`; a lista termina onde `next_cursor` vem nulo. Um comprovante por página. **Autenticação.** Token de pessoa do Console com o papel `security`, `integration` (ou admin), ou chave de fonte com o escopo `admin`. operationId: list_profiles_v1_profiles_get parameters: - in: query name: order required: false schema: $ref: '#/components/schemas/ListOrder' default: last_seen_desc description: >- A ordem: `last_seen_desc`, a atividade mais recente primeiro (o padrão), ou `last_seen_asc`, quem está há mais tempo sem atividade primeiro. example: last_seen_desc - in: query name: kind required: false schema: anyOf: - $ref: '#/components/schemas/SubjectKind' - type: 'null' title: Kind description: 'Só perfis deste tipo: `person`, `account` ou `partner`.' - in: query name: cursor required: false schema: anyOf: - maxLength: 64 type: string - type: 'null' title: Cursor description: O `next_cursor` da página anterior, como veio. - in: query name: limit required: false schema: default: 50 maximum: 100 minimum: 1 title: Limit type: integer description: Quantas linhas por página, de 1 a 100; o padrão é 50. example: 50 responses: '200': content: application/json: schema: $ref: '#/components/schemas/Page_ProfileListed_' example: items: - profile_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e01 pseudonym: p_kvkv3okp7vnw3mqs kind: person handles: - type: phone_e164 value: +14*****0123 last_seen: '2026-09-22T17:07:03Z' - type: system_id value: 48*13 last_seen: '2026-09-20T09:12:40Z' handle_count: 2 last_seen: '2026-09-22T17:07:03Z' next_cursor: 1790096823000000.0192f7a15b107c3a8e214d2f8a4c0e02 description: Uma página de perfis, com o cursor da próxima. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: O pedido não bate com o contrato. security: - sourceKey: [] - personToken: [] components: schemas: ListOrder: enum: - last_seen_desc - last_seen_asc title: ListOrder type: string SubjectKind: enum: - person - account - partner title: SubjectKind type: string description: >- Uma pessoa, uma organização cliente (`account`) ou uma organização que participa sem ser cliente (`partner`). Page_ProfileListed_: additionalProperties: false properties: items: items: $ref: '#/components/schemas/ProfileListed' title: Items type: array next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor required: - items title: Page[ProfileListed] type: object Problem: additionalProperties: false description: >- Detalhes do problema no formato da RFC 9457; `code` vem do catálogo de erros versionado. properties: code: title: Code type: string detail: anyOf: - type: string - type: 'null' default: null title: Detail request_id: anyOf: - type: string - type: 'null' default: null title: Request Id status: title: Status type: integer title: title: Title type: string type: default: about:blank title: Type type: string required: - title - status - code title: Problem type: object ProfileListed: additionalProperties: false description: >- Uma linha da lista de clientes: o bastante para reconhecer um cliente e abrir a memória dele, nunca um identificador por inteiro. properties: handle_count: description: Quantos identificadores o perfil tem. title: Handle Count type: integer handles: description: Os três com a atividade mais recente, o mais recente primeiro. items: $ref: '#/components/schemas/ListedHandle' title: Handles type: array kind: $ref: '#/components/schemas/SubjectKind' last_seen: description: A atividade mais recente em qualquer identificador do perfil. format: date-time title: Last Seen type: string profile_id: format: uuid title: Profile Id type: string pseudonym: title: Pseudonym type: string required: - profile_id - pseudonym - kind - handles - handle_count - last_seen title: ProfileListed type: object ListedHandle: additionalProperties: false properties: last_seen: format: date-time title: Last Seen type: string type: $ref: '#/components/schemas/HandleType' value: description: >- Sempre mascarado, seja qual for o papel de quem chama: um contato pelas pontas, um documento pelos dois últimos caracteres, um ID opaco pelos dois primeiros e os dois últimos. title: Value type: string required: - type - value - last_seen title: ListedHandle type: object HandleType: enum: - phone_e164 - wa_id - wa_jid - wa_lid - wa_bsuid - email - gov_id_hmac - app_user_id - system_id - org_registry_hmac - email_domain - anon_id title: HandleType type: string description: >- O tipo de identificador. O valor é classificado pelo formato, nunca pelo campo de onde veio. securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... personToken: type: http scheme: bearer bearerFormat: JWT ````