API de linha do tempo de redes de fraude

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

Obtenha o histórico de eventos de uma rede. Sem contract, a resposta é o histórico da própria rede, do mais antigo para o mais recente e sem paginação: quando ela foi detectada pela primeira vez, quando cada sinal foi observado pela última vez e sua mudança de status mais recente, com o motivo. Esse formato não mudou, e limit, cursor e event_type são ignorados.

Linha do tempo tipada

Envie contract=2 para ler a linha do tempo tipada. Ela acrescenta o que as contas dos membros fizeram e o que sua equipe fez a respeito da rede, do mais recente para o mais antigo, uma página por vez. contract aceita apenas 2; qualquer outro valor retorna 400.

Parâmetro	Significado
`limit`	Eventos por página, de 1 a 500. O padrão é 100.
`cursor`	O `next_cursor` da página anterior. Um cursor inválido ou vazio retorna `400`.
`event_type`	Os tipos de evento a manter, repetidos ou separados por vírgula, no máximo 20 valores. O padrão é todos os tipos.

A resposta é {"results": [...], "next_cursor": "..."}. Leia a próxima página com cursor definido como next_cursor, até que next_cursor seja null.

Tipos de evento

`event_type`	O que registra	Bloco de detalhes
`network_detected`	A rede foi detectada	Nenhum
`signal_observed`	A observação mais recente de um sinal	Nenhum
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	A mudança de status mais recente da rede, com o motivo em `metadata`	Nenhum
`verification_attempt`	Uma sessão de verificação de um membro (uma pessoa ou uma empresa), numerada (`attempt` de `attempt_count`), com os motivos de recusa quando recusada	`verification_attempt`
`transaction`	Uma transação da qual um membro participou, datada pela data da transação	`transaction`
`login`	Um login ou uma tentativa de login malsucedida que você enviou em nome de um membro pela API de eventos	`login`
`rule_hit`	Uma regra ativa que correspondeu a uma transação ou a um evento de um membro	`rule_hit`
`case_linked`	Um caso aberto para a rede na sua organização	`case_linked`
`note_added`	Uma nota deixada na rede, sem o texto	`note_added`

Eventos note_added são retornados apenas para membros do console, nunca para uma chave de API. Uma transação entre dois membros aparece uma vez para cada um deles, cada uma com seu próprio account. Um acionamento de regra nessa transação aparece uma única vez. Eventos de login existem apenas para os logins que você envia como eventos: auth.login, security.login_succeeded e suas formas de falha.

Contas e registros

Cada evento de membro traz account, o membro a que pertence, e source_ref, a sessão, sessão empresarial, transação, evento de monitoramento ou caso do qual ele foi lido. ownership é owned quando o registro pertence à aplicação que você chamou, e organization quando pertence a outra aplicação da sua organização. route informa o tipo, o UUID e a aplicação do registro; source_ref não tem route para um evento de monitoramento ou um caso. Os eventos da própria rede não trazem nem account nem source_ref.

Conteúdo relacionado

Autorizações

x-api-key

string

header

obrigatório

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.

Parâmetros de caminho

organization_id

string<uuid>

obrigatório

UUID da organização.

application_id

string<uuid>

obrigatório

UUID da aplicação.

network_uuid

string<uuid>

obrigatório

UUID da rede.

Exemplo:

"n3a5e000-0000-4000-8000-000000000001"

Parâmetros de consulta

contract

enum<string>

2 retorna a linha do tempo tipada. Omita-o para obter a linha do tempo padrão. Qualquer outro valor retorna 400.

Opções disponíveis:

2

limit

integer

padrão:100

Somente para a linha do tempo tipada. Eventos por página, de 1 a 500. O padrão é 100.

Intervalo obrigatório: 1 <= x <= 500

cursor

string

Somente para a linha do tempo tipada. O next_cursor da página anterior. Um cursor inválido ou vazio retorna 400.

event_type

enum<string>[]

Somente para a linha do tempo tipada. Tipos de evento a manter, repetidos ou separados por vírgula, com no máximo 20 valores. O padrão é todos os tipos.

Maximum array length: 20

Opções disponíveis:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Resposta

Sem contract: {results}, do mais antigo para o mais recente, sem paginação. Com contract=2: {results, next_cursor}, do mais recente para o mais antigo.

Default timeline (no contract)
Typed timeline page (contract=2)

Sem contract: os eventos da própria rede, do mais antigo ao mais recente, sem paginação.

results

object[]

Show child attributes

Última modificação em 1 de novembro de 2026

​Linha do tempo tipada

​Tipos de evento

​Contas e registros

​Conteúdo relacionado

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Linha do tempo tipada

Tipos de evento

Contas e registros

Conteúdo relacionado