> ## 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 asserções

> O registro imutável que diz quais handles pertencem ao mesmo sujeito, e por quê.



## OpenAPI

````yaml openapi/pt/cell.json GET /v1/identity/assertions
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-1
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/identity/assertions:
    get:
      tags:
        - identity
      summary: Listar asserções
      description: >-
        O registro imutável da identidade: quais handles foram declarados do
        mesmo sujeito, por qual método, com qual evidência, e se a asserção foi
        aplicada, está pendente ou foi recusada. Filtre por perfil ou por
        estado.


        **Autenticação.** Token de pessoa do Console com o papel `security`,
        `integration` (ou admin), ou chave de fonte com o escopo `admin`.
      operationId: list_assertions_v1_identity_assertions_get
      parameters:
        - in: query
          name: profile_id
          required: false
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            title: Profile Id
          description: Só as asserções deste perfil.
          example: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e01
        - in: query
          name: state
          required: false
          schema:
            anyOf:
              - enum:
                  - applied
                  - pending
                  - rejected
                type: string
              - type: 'null'
            title: State
          description: >-
            `applied`, `pending` (esperando a união fora da requisição) ou
            `rejected`.
        - in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            title: Cursor
          description: Cursor opaco, vindo de `next_cursor`.
        - in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 200
            minimum: 1
            title: Limit
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Page_AssertionOut_'
              example:
                items:
                  - assertion_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e06
                    handle_a: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e02
                    handle_b: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e03
                    method: same_event
                    confidence: 0.99
                    level_at_capture: V1
                    origin_event_id: 0192f7a1-6a2b-7d11-9c3e-1a2b3c4d5e05
                    state: applied
                    actor: null
                    reason: null
                    created_at: '2025-11-03T13:10:00Z'
                    retracted_at: null
                next_cursor: null
          description: Uma página.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: >-
            422 `invalid_input`, `verification_not_allowed` ou
            `about_without_link`.
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    Page_AssertionOut_:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/AssertionOut'
          title: Items
          type: array
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      required:
        - items
      title: Page[AssertionOut]
      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
    AssertionOut:
      additionalProperties: false
      properties:
        actor:
          anyOf:
            - type: string
            - type: 'null'
          title: Actor
        assertion_id:
          format: uuid
          title: Assertion Id
          type: string
        confidence:
          title: Confidence
          type: number
        created_at:
          format: date-time
          title: Created At
          type: string
        handle_a:
          format: uuid
          title: Handle A
          type: string
        handle_b:
          format: uuid
          title: Handle B
          type: string
        level_at_capture:
          $ref: '#/components/schemas/Verification'
        method:
          $ref: '#/components/schemas/AssertionMethod'
        origin_event_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Origin Event Id
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
        retracted_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Retracted At
        state:
          enum:
            - applied
            - pending
            - rejected
          title: State
          type: string
      required:
        - assertion_id
        - handle_a
        - handle_b
        - method
        - state
        - confidence
        - level_at_capture
        - created_at
      title: AssertionOut
      type: object
    Verification:
      description: >-
        Nível de verificação da sessão. V0 autodeclarado, V1 plausível pelo
        canal, V2 atestado pelo canal, V3 desafiado (OTP ou login), V4 conferido
        com um sistema de registro ou por um atendente. `no_customer` vale para
        tarefas sem cliente presente e só é aceito de fontes de agente interno.
      enum:
        - V0
        - V1
        - V2
        - V3
        - V4
        - no_customer
      title: Verification
      type: string
    AssertionMethod:
      enum:
        - explicit_identify
        - otp
        - login
        - system_import
        - same_event
        - co_occurrence
        - channel_rotation
        - accepted_suggestion
        - external_resolver
        - declared
      title: AssertionMethod
      type: string
      description: Como a ligação entre dois handles foi estabelecida.
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````