> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API de análise de casos

> A API da Didit retorna análises de casos: criados vs. revisados, por responsável, blueprint e origem, taxa de ameaças, falsos positivos, SLA e fila.



Prompt da API de análises de casos
        Copiar o prompt para a área de transferência



      
      

\<pre>

\`Pull case analytics through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/statistics/

Authentication:
Use the x-api-key header with my Didit API key.

Query params:
\- date_from=YYYY-MM-DD (default: 30 days ago)
\- date_to=YYYY-MM-DD (default: today)
\- range cannot exceed 731 days; date_from must not be after date_to.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/statistics/?date_from=2026-06-01&date_to=2026-06-30" \
-H "x-api-key: YOUR_API_KEY"

Response 200 shape:
\{
"series": [{"date": "2026-06-01", "created": 4, "reviewed": 2}, ...],
"tables": {
"officer": [{"key": "officer@company.com", "created": ..., "resolved": ..., "threat_rate": ..., ...}, ...],
"blueprint": [{"key": "AML investigation:<uuid>", ...}, ...],
"source": [{"key": "MANUAL", ...}, ...],
"status": [{"key": "OPEN", ...}, ...]
},
"totals": {"created": ..., "assigned": ..., "resolved": ..., "threat_rate": ..., "false_positive_rate": ..., "unresolved": ..., "reassignment_rate": ..., "escalation_rate": ..., "avg_assign_hours": ..., "avg_resolve_hours": ..., "avg_handling_hours": ...},
"queue": {"open": 12, "overdue": 3}
}
Note: queue is a live snapshot, not scoped to date_from/date_to.

Failure modes:
\- 400 - invalid date format, date_from after date_to, or range over 731 days.
\- 401/403 - auth/permission errors (requires list:cases).

Side effects: none, pure read/aggregate.

For the full integration shape, see /integration/integration-prompt.`

\</pre>



      
      

Colar em

Métricas agregadas que embasam as [abas Overview e Analytics do Console](https://docs.didit.me/pt-br/console/case-management/analytics.md): uma série diária de casos criados vs. revisados, quatro tabelas de detalhamento, totais consolidados e a fila em tempo real de casos abertos/atrasados.## Relacionados- [Análises (Console)](https://docs.didit.me/pt-br/console/case-management/analytics.md)
- [Listar casos](https://docs.didit.me/pt-br/management-api/cases/list.md)


## OpenAPI

````yaml pt-br/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/statistics/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de verificação de identidade. Autentique-se com o cabeçalho x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/organization/{organization_id}/application/{application_id}/cases/statistics/:
    get:
      tags:
        - Cases
      summary: Análises de casos
      description: >-
        Análises agregadas de casos para o intervalo de datas (padrão: últimos
        30 dias; máximo de 731 dias). Gráficos, tabelas, totais, eventos de
        atribuição e contagens atuais da fila usam os mesmos filtros com escopo
        da aplicação. Os filtros usam os valores atuais dos casos. As datas se
        aplicam a cada evento de métrica, portanto casos mais antigos atribuídos
        ou resolvidos durante o período continuam incluídos. A profundidade da
        fila independe do intervalo de datas. Filtros inválidos retornam 400; um
        blueprint ou responsável desconhecido retorna um resultado vazio.
      operationId: get_case_analytics
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID da organização.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID da aplicação.
        - name: date_from
          in: query
          schema:
            type: string
            format: date
          description: Início do intervalo (inclusivo). O padrão é 30 dias atrás.
        - name: date_to
          in: query
          schema:
            type: string
            format: date
          description: Fim do intervalo (inclusivo). O padrão é hoje.
        - name: blueprint
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Filtra pelo UUID do blueprint atual.
        - name: assigned_to
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Filtra pelo UUID do usuário revisor atualmente atribuído.
        - name: priority
          in: query
          required: false
          schema:
            type: string
            enum:
              - LOW
              - MEDIUM
              - HIGH
          description: Filtrar pela prioridade atual do caso.
        - name: source
          in: query
          required: false
          schema:
            type: string
            enum:
              - MANUAL
              - AML_SCREENING
              - TRANSACTION_RULE
              - WORKFLOW_BUILDER
          description: Filtrar pela origem de criação do caso.
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - OPEN
              - AWAITING_USER
              - RESOLVED
          description: Filtrar pelo status atual do caso.
      responses:
        '200':
          description: Payload de análise.
          content:
            application/json:
              schema:
                type: object
                properties:
                  series:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date
                        created:
                          type: integer
                        reviewed:
                          type: integer
                  tables:
                    type: object
                    properties:
                      officer:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                Valor da dimensão: e-mail do responsável,
                                "blueprint_name:uuid", origem ou status.
                                "unassigned"/"none" para dimensões ausentes.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                      blueprint:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                Valor da dimensão: e-mail do responsável,
                                "blueprint_name:uuid", origem ou status.
                                "unassigned"/"none" para dimensões ausentes.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                      source:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                Valor da dimensão: e-mail do responsável,
                                "blueprint_name:uuid", origem ou status.
                                "unassigned"/"none" para dimensões ausentes.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                      status:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: >-
                                Valor da dimensão: e-mail do responsável,
                                "blueprint_name:uuid", origem ou status.
                                "unassigned"/"none" para dimensões ausentes.
                            created:
                              type: integer
                            assigned:
                              type: integer
                            resolved:
                              type: integer
                            threat_rate:
                              type: number
                              format: float
                            false_positive_rate:
                              type: number
                              format: float
                            unresolved:
                              type: integer
                            reassignment_rate:
                              type: number
                              format: float
                            escalation_rate:
                              type: number
                              format: float
                            avg_assign_hours:
                              type: number
                              format: float
                            avg_resolve_hours:
                              type: number
                              format: float
                            avg_handling_hours:
                              type: number
                              format: float
                  totals:
                    type: object
                    properties:
                      created:
                        type: integer
                      assigned:
                        type: integer
                      resolved:
                        type: integer
                      threat_rate:
                        type: number
                        format: float
                      false_positive_rate:
                        type: number
                        format: float
                      unresolved:
                        type: integer
                      reassignment_rate:
                        type: number
                        format: float
                      escalation_rate:
                        type: number
                        format: float
                      avg_assign_hours:
                        type: number
                        format: float
                      avg_resolve_hours:
                        type: number
                        format: float
                      avg_handling_hours:
                        type: number
                        format: float
                  queue:
                    type: object
                    description: >-
                      Instantâneo em tempo real, não restrito ao intervalo de
                      datas.
                    properties:
                      open:
                        type: integer
                      overdue:
                        type: integer
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/statistics/?date_from=2026-06-01&date_to=2026-06-30'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            client = Didit()

            result = client.cases.retrieve_statistics()
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            const didit = new Didit();

            const result = await didit.cases.retrieveStatistics();
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.RetrieveStatistics(ctx, didit.CasesRetrieveStatisticsParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            Didit client = new Didit();

            var result = client.cases().retrieveStatistics();
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            $didit = new DiditClient();

            $result = $didit->cases->retrieveStatistics();
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            didit = Didit::Client.new

            result = didit.cases.retrieve_statistics
            puts result.to_h
        - lang: csharp
          label: .NET
          source: |-
            using System;
            using System.Text.Json;
            using Didit;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            using var client = new DiditClient();

            var result = await client.Cases.RetrieveStatisticsAsync();
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Chave de API da sua aplicação, em Developers -> API keys no Business
        Console. A chave principal tem acesso total. Uma chave nomeada pode ter
        escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada
        a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a
        uma data de validade. 401 significa que a chave está errada, revogada ou
        expirada; 403 significa que nenhuma chave foi enviada, que a chave não
        tem acesso a este recurso ou ação, ou que a requisição veio de um
        endereço fora da sua lista de IPs; 404 em uma rota de sessão significa
        que a sessão está fora dos fluxos ou status da chave. Uma chave sem
        acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave
        sem permissão de escrita em sessões recebe links e tokens de sessão como
        null. Consulte https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.