> ## 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 contrafactuais > Os relatórios de contrafactual, do mais novo para o mais antigo. ## OpenAPI ````yaml openapi/pt/cell.json GET /v1/measure/counterfactual-runs 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/measure/counterfactual-runs: get: tags: - signals summary: Listar contrafactuais description: >- Os relatórios de contrafactual do espaço, do mais novo para o mais antigo. **Autenticação.** Chave de fonte com o escopo `replay`, ou token de pessoa do Console com o papel `analysis` (ou admin). Só responde num espaço com a funcionalidade `measurement` ligada (o documento `features`); num espaço sem ela, 404. operationId: counterfactual_runs_v1_measure_counterfactual_runs_get parameters: - in: query name: cursor required: false schema: anyOf: - maxLength: 200 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/CounterfactualRunPage' description: Uma página de relatórios. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: O pedido não bate com o contrato. security: - sourceKey: [] - personToken: [] components: schemas: CounterfactualRunPage: additionalProperties: false properties: items: items: $ref: '#/components/schemas/CounterfactualRun' title: Items type: array next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor required: - items title: CounterfactualRunPage 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 CounterfactualRun: additionalProperties: false description: >- Se o elemento muda o que a ferramenta devolve, além do ruído da própria ferramenta. Nunca diz se o resultado melhorou, nem como o modelo reage: `limits` diz isso, e o que mais segura a resposta. properties: above_noise: title: Above Noise type: integer below_noise: description: Casos concluídos cuja sobreposição fica abaixo do próprio ruído. title: Below Noise type: integer cases: title: Cases type: integer completed: title: Completed type: integer created_at: format: date-time title: Created At type: string effect: anyOf: - type: number - type: 'null' description: >- `noise_floor - overlap`: quanto das primeiras posições o elemento move além do ruído. title: Effect element: enum: - constraints - hard - size - exclude title: Element type: string engaged: $ref: '#/components/schemas/CounterfactualEngagement' label: anyOf: - type: string - type: 'null' title: Label limits: items: enum: - not_quality - model_reaction_not_measured - trivial_for_hard - few_cases - noisy_tool - cases_skipped - dry_run type: string title: Limits type: array noise_floor: anyOf: - type: number - type: 'null' description: overlap@k médio da base com ela mesma. title: Noise Floor overlap: anyOf: - type: number - type: 'null' description: overlap@k médio da base com a variante. title: Overlap p_value: anyOf: - type: number - type: 'null' description: >- O teste do sinal bilateral de `below_noise` contra `above_noise`: quão provável é uma divisão assim desigual quando o elemento não muda nada. title: P Value run_id: maxLength: 512 minLength: 1 title: Run Id type: string skipped: additionalProperties: type: integer description: Os casos não concluídos. propertyNames: enum: - completed - no_dry_run - tool_error - infrastructure_error title: Skipped type: object ties: title: Ties type: integer tool: title: Tool type: string required: - run_id - tool - element - created_at - cases - completed - overlap - noise_floor - effect - below_noise - above_noise - ties - p_value - engaged - limits title: CounterfactualRun type: object CounterfactualEngagement: additionalProperties: false description: >- Para onde foram, sem o elemento, os itens com que a pessoa interagiu, nos casos concluídos. properties: gained: description: Entre os primeiros `k` da variante e fora dos da base. title: Gained type: integer items: title: Items type: integer kept: description: Entre os primeiros `k` das duas listas. title: Kept type: integer lost: description: Entre os primeiros `k` da base e fora dos da variante. title: Lost type: integer mean_shift: anyOf: - type: number - type: 'null' description: >- A posição na variante menos a posição na base, em média sobre os itens que as duas listas têm; positivo quando eles caíram. title: Mean Shift shown: description: Entre os primeiros `k` da lista da base. title: Shown type: integer required: - items - shown - kept - lost - gained title: CounterfactualEngagement type: object securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... personToken: type: http scheme: bearer bearerFormat: JWT ````