> ## 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 timeline della rete di frodi > Ottieni gli eventi di una rete di frodi in Didit; con contract=2, una timeline paginata di tentativi, transazioni, accessi, regole e casi. Prompt API della cronologia di rete Copia il prompt negli appunti \

\`Retrieve a fraud network's event timeline through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/

Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.

Path parameter:
\- network_uuid - the network's UUID.

Two shapes, chosen by the contract query parameter:

1\. Default (no contract parameter): unchanged.
Response 200: {"results": [NetworkTimelineEvent, ...]}, oldest first, not paginated.
Each event has event_type (network_detected, signal_observed, network_active, network_in_review, network_resolved, network_dismissed), occurred_at, label, and metadata (event-specific, e.g. {network_id} for detection, {signal_type, subject_count, is_hub} for a signal observation, {reason} for a status change).
limit, cursor and event_type are ignored in this mode.

2\. Typed timeline (contract=2, opt-in):
Query params:
\- contract=2: required for this mode. Any other value is a 400.
\- limit: 1 to 500, default 100.
\- cursor: the previous page's next_cursor. An invalid or empty cursor is a 400 ("This cursor is not valid. Reload the feed.").
\- event_type: repeat it or pass a comma-separated list, at most 20 values. Defaults to every type: network_detected, signal_observed, network_active, network_in_review, network_resolved, network_dismissed, verification_attempt, transaction, login, rule_hit, case_linked, note_added.
Response 200: {"results": [NetworkTypedTimelineEvent, ...], "next_cursor": string|null}, newest first. Keep calling with cursor=next_cursor until next_cursor is null.
Each typed event has:
\- event_type, occurred_at, label, metadata: as in the default shape (metadata is {} for events that are not the network's own).
\- id: ":", unique within the timeline. ingested_at: when Didit stored it.
\- account: the member account {node_id ("vendor_user:", "vendor_business:" or "transaction_party:"), node_type (account|business_account|transaction_party), uuid, vendor_data, display_name, ownership (owned|organization), route {kind, id, application_id}}. Null for the network's own events, case_linked and note_added.
\- source_ref: the record it was read from {kind (session|business_session|transaction|monitoring_event|case), id, ownership, route}. route is absent for monitoring_event and case. Null for the network's own events and note_added.
\- ownership: owned when the record belongs to the application I called, organization when it belongs to another application of my organization.
\- One detail block per event type, the others null:
\- verification_attempt {session_id, session_number, attempt, attempt_count, status, status_changed_at, decline_reasons [{risk, feature, short_description}] (declined sessions only)}
\- transaction {transaction_id, transaction_number, transaction_type, action_type, amount {value, currency, direction} or null, status, decision_reason_code, decision_reason_label, party_role}
\- login {action (auth.login, security.login_succeeded, auth.login_failed or security.login_failed), succeeded, status, ip {address, country_code, city, connection_type (free text), is_vpn_or_tor, is_data_center} or null, device {fingerprint, label} or null, is_first_login, is_new_device}
\- rule_hit {rule_id, rule_title, rule_category, rule_source, severity, score_delta, status_target, action_summary}
\- case_linked {case_id, case_number, status, author_email, author_name}
\- note_added {note_id, author_email}: never returned to an API key, only to console members.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/?contract=2&limit=50&event_type=verification_attempt,login" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 400 (contract mode only): {"contract": [...]}, {"limit": [...]}, {"cursor": ["This cursor is not valid. Reload the feed."]} or {"event_type": {...}}.
\- 404: {"detail": "Network not found."}. The network does not exist, or has no member visible to this application.
\- 401: missing or invalid x-api-key.
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs read:networks.
\- 403 with {"code": "networks_not_entitled"}: Networks is not enabled for the organization.

Side effects: none, pure read.

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

\
Incolla in Recupera la cronologia degli eventi di una rete. Senza `contract`, la risposta contiene la cronologia della rete stessa, dal più vecchio al più recente e senza paginazione: quando è stata rilevata per la prima volta, quando ciascun segnale è stato osservato l'ultima volta e la sua ultima variazione di stato con il relativo motivo. Questa struttura non cambia e `limit`, `cursor` ed `event_type` vengono ignorati.## Cronologia tipizzataPassa `contract=2` per leggere invece la cronologia tipizzata. Aggiunge le azioni degli account dei membri e le azioni del tuo team sulla rete, dal più recente al più vecchio, una pagina alla volta. `contract` accetta solo `2`; qualsiasi altro valore restituisce `400`.| Parametro | Significato | | - | - | | `limit` | Eventi per pagina, da 1 a 500. Il valore predefinito è 100. | | `cursor` | Il `next_cursor` della pagina precedente. Un cursore non valido o vuoto restituisce `400`. | | `event_type` | I tipi di evento da mantenere, ripetuti o separati da virgole, al massimo 20 valori. Per impostazione predefinita, include tutti i tipi. |La risposta è `{"results": [...], "next_cursor": "..."}`. Leggi la pagina successiva impostando `cursor` su `next_cursor`, finché `next_cursor` non è `null`.## Tipi di evento| `event_type` | Cosa registra | Blocco di dettaglio | | - | - | - | | `network_detected` | La rete è stata rilevata | Nessuno | | `signal_observed` | L'ultima osservazione di un segnale | Nessuno | | `network_active`, `network_in_review`, `network_resolved`, `network_dismissed` | L'ultima variazione di stato della rete, con il motivo in `metadata` | Nessuno | | `verification_attempt` | Una sessione di verifica di un membro (una persona o un'azienda), numerata (`attempt` di `attempt_count`), con i motivi del rifiuto quando è rifiutata | `verification_attempt` | | `transaction` | Una transazione a cui ha partecipato un membro, datata con la data della transazione | `transaction` | | `login` | Un accesso o un tentativo di accesso non riuscito che hai inviato per un membro tramite l'[API degli eventi](https://docs.didit.me/it/transaction-monitoring/events.md) | `login` | | `rule_hit` | Una regola attiva che ha rilevato una corrispondenza con la transazione o l'evento di un membro | `rule_hit` | | `case_linked` | Un caso aperto per la rete nella tua organizzazione | `case_linked` | | `note_added` | Una nota lasciata sulla rete, senza il suo testo | `note_added` |Gli eventi `note_added` vengono restituiti solo ai membri della console, mai a una chiave API. Una transazione tra due membri compare una volta per ciascuno di loro, ognuna con il proprio `account`. Una corrispondenza di regola relativa a quella transazione compare una sola volta. Gli eventi di accesso esistono solo per gli accessi che invii come eventi: `auth.login`, `security.login_succeeded` e le loro forme non riuscite.## Account e recordOgni evento di un membro contiene `account`, il membro a cui appartiene, e `source_ref`, la sessione, la sessione aziendale, la transazione, l'evento di monitoraggio o il caso da cui è stato letto. `ownership` vale `owned` quando il record appartiene all'applicazione che hai chiamato, e `organization` quando appartiene a un'altra applicazione della tua organizzazione. `route` indica il tipo di record, il suo UUID e l'applicazione; `source_ref` non ha `route` per un evento di monitoraggio o per un caso. Gli eventi propri della rete non contengono né `account` né `source_ref`.## Correlati- [Ottieni la rete](https://docs.didit.me/it/management-api/networks/get.md) - [Segnali della rete](https://docs.didit.me/it/management-api/networks/signals.md) - [Mappa della rete](https://docs.didit.me/it/management-api/networks/map.md) - [Acquisizione di eventi](https://docs.didit.me/it/transaction-monitoring/events.md) ## OpenAPI ````yaml it/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/: get: tags: - Networks summary: Recupera timeline della rete description: >- Senza `contract`: gli eventi della rete stessa (rilevamento, l'osservazione più recente di ciascun segnale e la relativa revisione), dal più vecchio al più recente e non impaginati. `limit`, `cursor` e `event_type` vengono ignorati. Con `contract=2`: la cronologia tipizzata, dalla più recente alla più vecchia e impaginata tramite cursore. Aggiunge le azioni eseguite dagli account membri (tentativi di verifica, transazioni, accessi inviati tramite l'API eventi e le regole attive che hanno attivato) e i casi aperti per la rete. Gli eventi `note_added` vengono restituiti solo ai membri della console, mai a una chiave API. Richiede una chiave API con accesso completo o `read:networks` per un membro della console. operationId: get_network_timeline parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID dell'organizzazione. - name: application_id in: path required: true schema: type: string format: uuid description: UUID dell'applicazione. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID della rete. - name: contract in: query required: false schema: type: string enum: - '2' description: >- `2` restituisce la cronologia tipizzata. Omettilo per la cronologia predefinita. Qualsiasi altro valore restituisce 400. - name: limit in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 500 description: >- Solo cronologia con tipizzazione. Eventi per pagina, da 1 a 500. Il valore predefinito è 100. - name: cursor in: query required: false schema: type: string description: >- Solo cronologia con tipizzazione. Il `next_cursor` della pagina precedente. Un cursore non valido o vuoto restituisce 400. - name: event_type in: query required: false style: form explode: true schema: type: array maxItems: 20 items: type: string enum: - network_detected - signal_observed - network_active - network_in_review - network_resolved - network_dismissed - verification_attempt - transaction - login - rule_hit - case_linked - note_added description: >- Solo cronologia con tipizzazione. Tipi di eventi da conservare, ripetuti o separati da virgola, massimo 20 valori. Il valore predefinito include tutti i tipi. responses: '200': description: >- Senza `contract`: `{results}`, i meno recenti per primi, non impaginati. Con `contract=2`: `{results, next_cursor}`, i più recenti per primi. content: application/json: schema: oneOf: - $ref: '#/components/schemas/NetworkTimeline' - $ref: '#/components/schemas/NetworkTimelinePage' examples: Default timeline: summary: Senza contract value: 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. Typed timeline: summary: Con contract=2 value: results: - id: monitoring_event:9b2f1c3e-4d5a-4b6c-8d7e-0f1a2b3c4d5e event_type: login occurred_at: '2026-10-12T18:41:02Z' ingested_at: '2026-10-12T18:41:03Z' label: Login metadata: {} account: node_id: vendor_user:5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f node_type: account uuid: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f vendor_data: user-1042 display_name: Alex Example ownership: owned route: kind: user id: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee source_ref: kind: monitoring_event id: 9b2f1c3e-4d5a-4b6c-8d7e-0f1a2b3c4d5e ownership: owned verification_attempt: null transaction: null login: action: auth.login succeeded: true status: APPROVED ip: address: 203.0.113.24 country_code: ES city: Madrid connection_type: null is_vpn_or_tor: false is_data_center: false device: fingerprint: fp_0a1b2c3d label: Chrome · Android is_first_login: false is_new_device: true rule_hit: null case_linked: null note_added: null - id: session:1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f event_type: verification_attempt occurred_at: '2026-10-12T16:03:10Z' ingested_at: '2026-10-12T16:03:10Z' label: Verification attempt 2 of 2 metadata: {} account: node_id: vendor_user:5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f node_type: account uuid: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f vendor_data: user-1042 display_name: Alex Example ownership: owned route: kind: user id: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee source_ref: kind: session id: 1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f ownership: owned route: kind: session id: 1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee verification_attempt: session_id: 1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f session_number: 1287 attempt: 2 attempt_count: 2 status: Approved status_changed_at: '2026-10-12T16:05:41Z' decline_reasons: [] transaction: null login: null rule_hit: null case_linked: null note_added: null - id: signal_observed:8d7c6b5a-4e3f-4a2b-9c1d-0e9f8a7b6c5d event_type: signal_observed occurred_at: '2026-10-12T16:03:10Z' ingested_at: '2026-10-01T09:12:44Z' label: device observed metadata: signal_type: device subject_count: 3 is_hub: false account: null source_ref: null verification_attempt: null transaction: null login: null rule_hit: null case_linked: null note_added: null next_cursor: >- eyJ0IjoiMjAyNi0xMC0xMlQxNjowMzoxMCswMDowMCIsImMiOiIyMDI2LTEwLTAxVDA5OjEyOjQ0KzAwOjAwIiwiciI6MSwidSI6IjhkN2M2YjVhLTRlM2YtNGEyYi05YzFkLTBlOWY4YTdiNmM1ZCJ9 '400': description: >- Con `contract` presente: un valore non valido per `contract`, `limit`, `cursor` o `event_type`. content: application/json: examples: Unsupported contract: summary: Contratto non supportato value: contract: - '"3" is not a valid choice.' Invalid cursor: summary: Cursore non valido value: cursor: - This cursor is not valid. Reload the feed. Limit too large: summary: Limite troppo elevato value: limit: - Ensure this value is less than or equal to 500. Unknown event type: summary: Tipo di evento sconosciuto value: event_type: '0': - '"logout" is not a valid choice.' '401': description: Credenziali mancanti o non valide. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Missing or invalid credentials: summary: Credenziali mancanti o non valide value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- La chiave API appartiene a un'altra applicazione, oppure è una chiave con accesso limitato: gli endpoint Networks richiedono una chiave con accesso completo. Un token di un membro della console richiede `read:networks`. Viene restituito anche con `code: networks_not_entitled` quando Networks non è abilitato per l'organizzazione. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Networks not enabled: summary: Reti non abilitate value: detail: >- Networks is disabled for this organization. Contact Didit support if you believe this is an error. code: networks_not_entitled Restricted API key: summary: Chiave API con restrizioni value: detail: This API key has no access to this endpoint. No permission: summary: Nessuna autorizzazione value: detail: You do not have permission to perform this action. '404': description: Rete non trovata (o non visibile per questa applicazione). content: application/json: schema: type: object properties: detail: type: string 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/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \ -H 'x-api-key: YOUR_API_KEY' - lang: curl label: curl (typed timeline) source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/3fa85f64-5717-4562-b3fc-2c963f66afa6/timeline/?contract=2&limit=50&event_type=verification_attempt,login' \ -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.networks.retrieve_timeline( "n3a5e000-0000-4000-8000-000000000001", ) 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.networks.retrieveTimeline("n3a5e000-0000-4000-8000-000000000001"); 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.Networks.RetrieveTimeline(ctx, \"n3a5e000-0000-4000-8000-000000000001\", didit.NetworksRetrieveTimelineParams{})\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.networks().retrieveTimeline("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveTimeline('n3a5e000-0000-4000-8000-000000000001'); 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.networks.retrieve_timeline("n3a5e000-0000-4000-8000-000000000001") 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.Networks.RetrieveTimelineAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkTimeline: title: Default timeline (no contract) type: object description: >- Senza `contract`: gli eventi della rete stessa, dal più vecchio al più recente, non impaginati. properties: results: type: array items: $ref: '#/components/schemas/NetworkTimelineEvent' NetworkTimelinePage: title: Typed timeline page (contract=2) type: object description: >- Con `contract=2`: una pagina di eventi tipizzati, i più recenti per primi. properties: results: type: array items: $ref: '#/components/schemas/NetworkTypedTimelineEvent' next_cursor: type: string nullable: true description: >- Passalo come `cursor` per leggere la pagina successiva. Null nell'ultima pagina. NetworkTimelineEvent: type: object properties: event_type: type: string description: >- ad es. network_detected, signal_observed, network_in_review, network_resolved, network_dismissed. occurred_at: type: string format: date-time nullable: true label: type: string metadata: type: object NetworkTypedTimelineEvent: type: object description: >- Un singolo evento tipizzato della timeline: i quattro campi predefiniti, più il relativo id, la data e ora in cui Didit lo ha memorizzato, l'account membro e il record a cui appartiene, e il blocco dei dettagli del rispettivo tipo di evento. Gli altri blocchi dei dettagli sono null. properties: id: type: string description: '`:`, univoco all''interno della cronologia.' example: session:3fa85f64-5717-4562-b3fc-2c963f66afa6 event_type: type: string enum: - network_detected - signal_observed - network_active - network_in_review - network_resolved - network_dismissed - verification_attempt - transaction - login - rule_hit - case_linked - note_added occurred_at: type: string format: date-time description: Quando è avvenuto. ingested_at: type: string format: date-time description: Quando Didit lo ha archiviato. label: type: string description: >- Una breve etichetta in inglese, ad esempio `Verification attempt 2 of 3`. metadata: type: object description: >- Per gli eventi della rete stessa, gli stessi metadati della timeline predefinita. Vuoto in caso contrario. account: allOf: - $ref: '#/components/schemas/NetworkTimelineAccount' nullable: true description: >- L'account del membro. Null per gli eventi propri della rete, `case_linked` e `note_added`. source_ref: allOf: - $ref: '#/components/schemas/NetworkTimelineSourceRef' nullable: true description: >- Il record di origine. Null per gli eventi propri della rete e per `note_added`. verification_attempt: allOf: - $ref: '#/components/schemas/NetworkTimelineAttempt' nullable: true description: Impostato sugli eventi `verification_attempt`. transaction: allOf: - $ref: '#/components/schemas/NetworkTimelineTransaction' nullable: true description: Impostato sugli eventi `transaction`. login: allOf: - $ref: '#/components/schemas/NetworkTimelineLogin' nullable: true description: Impostato sugli eventi `login`. rule_hit: allOf: - $ref: '#/components/schemas/NetworkTimelineRuleHit' nullable: true description: Impostato sugli eventi `rule_hit`. case_linked: allOf: - $ref: '#/components/schemas/NetworkTimelineCaseLinked' nullable: true description: Impostato sugli eventi `case_linked`. note_added: allOf: - $ref: '#/components/schemas/NetworkTimelineNoteAdded' nullable: true description: >- Impostato sugli eventi `note_added`. Non viene mai restituito a una chiave API. NetworkTimelineAccount: type: object description: L'account del membro a cui appartiene l'evento. properties: node_id: type: string description: >- `:`, dove il tipo è `vendor_user`, `vendor_business` o `transaction_party`. example: vendor_user:3fa85f64-5717-4562-b3fc-2c963f66afa6 node_type: type: string enum: - account - business_account - transaction_party uuid: type: string format: uuid vendor_data: type: string nullable: true display_name: type: string nullable: true ownership: type: string enum: - owned - organization description: >- `owned` quando il record appartiene all'applicazione che hai chiamato (per un membro della console, a un'applicazione a cui ha accesso). `organization` quando appartiene a un'altra applicazione della tua organizzazione. route: $ref: '#/components/schemas/NetworkTimelineRoute' NetworkTimelineSourceRef: type: object description: Il record da cui è stato letto l'evento. properties: kind: type: string enum: - session - business_session - transaction - monitoring_event - case id: type: string format: uuid ownership: type: string enum: - owned - organization description: >- `owned` quando il record appartiene all'applicazione che hai chiamato (per un membro della console, a un'applicazione a cui ha accesso). `organization` quando appartiene a un'altra applicazione della tua organizzazione. route: allOf: - $ref: '#/components/schemas/NetworkTimelineRoute' description: Assente per `monitoring_event` e `case`. NetworkTimelineAttempt: type: object description: Una singola sessione di verifica dell'account. properties: session_id: type: string format: uuid description: >- L'UUID della sessione, o l'UUID della sessione aziendale per un'azienda. session_number: type: integer nullable: true attempt: type: integer description: >- La posizione di questa sessione tra le sessioni dell'account, in ordine di creazione. attempt_count: type: integer description: Quante sessioni ha l'account. status: type: string description: Lo stato della sessione, ad esempio `Approved` o `Declined`. status_changed_at: type: string format: date-time nullable: true decline_reasons: type: array items: $ref: '#/components/schemas/NetworkTimelineDeclineReason' description: >- Solo per una sessione rifiutata: i relativi avvisi, dal più vecchio al più recente, una volta per avviso. Vuoto in caso contrario. NetworkTimelineTransaction: type: object description: >- Una transazione a cui ha partecipato un account membro, con data corrispondente a quella della transazione. properties: transaction_id: type: string format: uuid transaction_number: type: integer nullable: true transaction_type: type: string action_type: type: string amount: allOf: - $ref: '#/components/schemas/NetworkTimelineAmount' nullable: true description: Null quando la transazione non ha alcun importo. status: type: string decision_reason_code: type: string nullable: true decision_reason_label: type: string nullable: true party_role: type: string description: >- Il ruolo dell'account nella transazione: `APPLICANT`, `REMITTER`, `BENEFICIARY` o `COUNTERPARTY`. NetworkTimelineLogin: type: object description: >- Un evento di accesso che hai inviato per una persona tramite l'API degli eventi. properties: action: type: string description: >- `.`: `auth.login` o `security.login_succeeded` per un accesso, `auth.login_failed` o `security.login_failed` per un accesso non riuscito. succeeded: type: boolean status: type: string description: Lo stato dell'evento. ip: allOf: - $ref: '#/components/schemas/NetworkTimelineIP' nullable: true description: Null quando l'evento non ha alcun indirizzo IP. device: allOf: - $ref: '#/components/schemas/NetworkTimelineDevice' nullable: true description: >- Null quando l'evento non ha impronta digitale o contesto del dispositivo. is_first_login: type: boolean description: Il primo accesso riuscito registrato per l'account. is_new_device: type: boolean description: >- Un accesso riuscito da un dispositivo dal quale non era stato effettuato alcuno dei precedenti accessi riusciti dell'account. Mai true al primo accesso. NetworkTimelineRuleHit: type: object description: >- Una regola attiva che ha trovato corrispondenza con una transazione o un evento di un membro. Le corrispondenze in modalità test non sono incluse. properties: rule_id: type: string format: uuid rule_title: type: string rule_category: type: string rule_source: type: string severity: type: string nullable: true score_delta: type: integer status_target: type: string nullable: true action_summary: type: string nullable: true NetworkTimelineCaseLinked: type: object description: >- Un caso aperto per la rete all'interno della tua organizzazione. `source_ref.ownership` indica se appartiene all'applicazione che hai chiamato. properties: case_id: type: string format: uuid case_number: type: string nullable: true status: type: string author_email: type: string nullable: true author_name: type: string nullable: true NetworkTimelineNoteAdded: type: object description: Una nota lasciata sulla rete. Il testo della nota non è incluso. properties: note_id: type: string format: uuid author_email: type: string NetworkTimelineRoute: type: object description: >- Dove si apre il record: il suo tipo, il suo UUID e l'applicazione a cui appartiene. properties: kind: type: string description: >- `user`, `business` o `transaction_party` per un account; `session`, `business_session` o `transaction` per un record di origine. id: type: string format: uuid application_id: type: string format: uuid NetworkTimelineDeclineReason: type: object properties: risk: type: string description: Il codice dell'avviso. feature: type: string description: La funzionalità che ha generato l'avviso. short_description: type: string NetworkTimelineAmount: type: object properties: value: type: string description: Importo decimale sotto forma di stringa. currency: type: string direction: type: string nullable: true NetworkTimelineIP: type: object properties: address: type: string country_code: type: string nullable: true city: type: string nullable: true connection_type: type: string nullable: true description: >- L'etichetta del tipo di connessione per l'indirizzo, come testo libero. is_vpn_or_tor: type: boolean is_data_center: type: boolean NetworkTimelineDevice: type: object properties: fingerprint: type: string nullable: true label: type: string nullable: true description: >- Un'etichetta leggibile del dispositivo creata a partire dal contesto del dispositivo dell'evento. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.