> ## 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 cronologia de xarxes de frau > Obtén l'historial de la xarxa de frau a Didit; amb contract=2, una cronologia paginada d'intents, transaccions, sessions, regles i casos. Prompt de l'API de cronologia de xarxa Copia el prompt al porta-retalls \

\`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.`

\
Enganxa a Recupera l'historial d'esdeveniments d'una xarxa. Sense `contract`, la resposta és l'historial propi de la xarxa, del més antic al més recent i sense paginació: quan es va detectar per primera vegada, quan es va observar per última vegada cada senyal i el seu darrer canvi d'estat amb el motiu. Aquesta forma no ha canviat, i `limit`, `cursor` i `event_type` s'ignoren.## Cronologia tipificadaPassa `contract=2` per llegir la cronologia tipificada. Afegeix el que van fer els comptes membres i el que va fer el teu equip sobre la xarxa, del més recent al més antic, una pàgina cada vegada. `contract` només accepta `2`; qualsevol altre valor retorna `400`.| Paràmetre | Significat | | - | - | | `limit` | Esdeveniments per pàgina, de 1 a 500. Per defecte, 100. | | `cursor` | El `next_cursor` de la pàgina anterior. Un cursor no vàlid o buit retorna `400`. | | `event_type` | Els tipus d'esdeveniment que cal conservar, repetits o separats per comes, com a màxim 20 valors. Per defecte, tots els tipus. |La resposta és `{"results": [...], "next_cursor": "..."}`. Llegeix la pàgina següent amb `cursor` igual a `next_cursor`, fins que `next_cursor` sigui `null`.## Tipus d'esdeveniment| `event_type` | Què registra | Bloc de detall | | - | - | - | | `network_detected` | La xarxa va ser detectada | Cap | | `signal_observed` | La darrera observació d'un senyal | Cap | | `network_active`, `network_in_review`, `network_resolved`, `network_dismissed` | El darrer canvi d'estat de la xarxa, amb el seu motiu a `metadata` | Cap | | `verification_attempt` | Una sessió de verificació d'un membre (una persona o una empresa), numerada (`attempt` de `attempt_count`), amb els motius de rebuig quan ha estat rebutjada | `verification_attempt` | | `transaction` | Una transacció en què va participar un membre, datada segons la seva data de transacció | `transaction` | | `login` | Un inici de sessió o un inici de sessió fallit que has enviat per a un membre mitjançant l'[API d'esdeveniments](https://docs.didit.me/ca/transaction-monitoring/events.md) | `login` | | `rule_hit` | Una regla activa que coincideix amb una transacció o un esdeveniment d'un membre | `rule_hit` | | `case_linked` | Un cas obert per a la xarxa a la teva organització | `case_linked` | | `note_added` | Una nota deixada sobre la xarxa, sense el seu text | `note_added` |Els esdeveniments `note_added` només es retornen als membres de la consola, mai a una clau d'API. Una transacció entre dos membres apareix una vegada per a cadascun, cadascuna amb el seu propi `account`. Una coincidència de regla sobre aquesta transacció apareix una sola vegada. Els esdeveniments d'inici de sessió només existeixen per als inicis de sessió que enviïs com a esdeveniments: `auth.login`, `security.login_succeeded` i les seves formes fallides.## Comptes i registresCada esdeveniment de membre inclou `account`, el membre al qual pertany, i `source_ref`, la sessió, la sessió empresarial, la transacció, l'esdeveniment de monitoratge o el cas del qual s'ha llegit. `ownership` és `owned` quan el registre pertany a l'aplicació que has cridat, i `organization` quan pertany a una altra aplicació de la teva organització. `route` indica el tipus de registre, el UUID i l'aplicació; `source_ref` no té `route` per a un esdeveniment de monitoratge ni per a un cas. Els esdeveniments propis de la xarxa no tenen ni `account` ni `source_ref`.## Relacionat- [Obtenir la xarxa](https://docs.didit.me/ca/management-api/networks/get.md) - [Senyals de la xarxa](https://docs.didit.me/ca/management-api/networks/signals.md) - [Mapa de la xarxa](https://docs.didit.me/ca/management-api/networks/map.md) - [Ingesta d'esdeveniments](https://docs.didit.me/ca/transaction-monitoring/events.md) ## OpenAPI ````yaml ca/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 de verificació d'identitat. Autentica't amb la capçalera 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: Obtenir la cronologia de la xarxa description: >- Sense `contract`: els esdeveniments propis de la xarxa (detecció, la darrera observació de cada senyal i la seva revisió), primer els més antics i sense paginació. S'ignoren `limit`, `cursor` i `event_type`. Amb `contract=2`: la línia temporal tipada, primer els més recents i paginada per cursor. Afegeix el que han fet els comptes dels membres (intents de verificació, transaccions, inicis de sessió que publiquis mitjançant l'API d'esdeveniments i les regles actives que s'han activat) i els casos oberts per a la xarxa. Els esdeveniments `note_added` només es retornen als membres de la consola, mai a una clau d'API. Requereix una clau d'API amb accés complet o `read:networks` per a un membre de la consola. operationId: get_network_timeline parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organització. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de l'aplicació. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID de la xarxa. - name: contract in: query required: false schema: type: string enum: - '2' description: >- `2` retorna la cronologia tipada. Omet-lo per a la cronologia per defecte. Qualsevol altre valor retorna 400. - name: limit in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 500 description: >- Només per a la cronologia tipada. Esdeveniments per pàgina, d'1 a 500. El valor per defecte és 100. - name: cursor in: query required: false schema: type: string description: >- Només per a la cronologia tipada. El `next_cursor` de la pàgina anterior. Un cursor buit o no vàlid retorna 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: >- Només per a la cronologia tipada. Tipus d'esdeveniments que cal mantenir, repetits o separats per comes, com a màxim 20 valors. Per defecte inclou tots els tipus. responses: '200': description: >- Sense `contract`: `{results}`, els més antics primer, sense paginar. Amb `contract=2`: `{results, next_cursor}`, els més recents primer. content: application/json: schema: oneOf: - $ref: '#/components/schemas/NetworkTimeline' - $ref: '#/components/schemas/NetworkTimelinePage' examples: Default timeline: summary: Sense 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: Amb 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: >- Amb `contract` present: un valor de `contract`, `limit`, `cursor` o `event_type` no vàlid. content: application/json: examples: Unsupported contract: summary: Contracte no admès value: contract: - '"3" is not a valid choice.' Invalid cursor: summary: Cursor no vàlid value: cursor: - This cursor is not valid. Reload the feed. Limit too large: summary: Límit massa gran value: limit: - Ensure this value is less than or equal to 500. Unknown event type: summary: Tipus d'esdeveniment desconegut value: event_type: '0': - '"logout" is not a valid choice.' '401': description: Falten les credencials o no són vàlides. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Present en errors codificats, per exemple `networks_not_entitled`. examples: Missing or invalid credentials: summary: Falten les credencials o no són vàlides value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- La clau d'API pertany a una altra aplicació o és una clau amb accés restringit: els endpoints de Networks necessiten una clau amb accés complet. Un token de membre de la consola necessita `read:networks`. També es retorna amb `code: networks_not_entitled` quan Networks no està habilitat per a l'organització. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Present en errors codificats, per exemple `networks_not_entitled`. examples: Networks not enabled: summary: Xarxes no habilitades 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: Clau d'API restringida value: detail: This API key has no access to this endpoint. No permission: summary: Sense permís value: detail: You do not have permission to perform this action. '404': description: No s'ha trobat la xarxa (o no és visible per a aquesta aplicació). 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: >- Sense `contract`: els esdeveniments propis de la xarxa, primer els més antics, sense paginació. properties: results: type: array items: $ref: '#/components/schemas/NetworkTimelineEvent' NetworkTimelinePage: title: Typed timeline page (contract=2) type: object description: >- Amb `contract=2`: una pàgina d'esdeveniments tipats, els més recents primer. properties: results: type: array items: $ref: '#/components/schemas/NetworkTypedTimelineEvent' next_cursor: type: string nullable: true description: >- Passa-ho com a `cursor` per llegir la pàgina següent. Null a l'última pàgina. NetworkTimelineEvent: type: object properties: event_type: type: string description: >- p. ex. 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 esdeveniment tipat de la línia temporal: els quatre camps per defecte, més el seu identificador, quan Didit el va emmagatzemar, el compte de membre i el registre al qual pertany, i el bloc de detalls del seu tipus d'esdeveniment. La resta de blocs de detalls són null. properties: id: type: string description: '`:`, únic dins de la 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: Quan va ocórrer. ingested_at: type: string format: date-time description: Quan Didit ho ha emmagatzemat. label: type: string description: >- Una etiqueta curta en anglès, per exemple `Verification attempt 2 of 3`. metadata: type: object description: >- Per als esdeveniments propis de la xarxa, les mateixes metadades que la línia de temps per defecte. Buit en cas contrari. account: allOf: - $ref: '#/components/schemas/NetworkTimelineAccount' nullable: true description: >- El compte de membre. Null per als esdeveniments propis de la xarxa, `case_linked` i `note_added`. source_ref: allOf: - $ref: '#/components/schemas/NetworkTimelineSourceRef' nullable: true description: >- El registre d'origen. Null per als esdeveniments propis de la xarxa i per a `note_added`. verification_attempt: allOf: - $ref: '#/components/schemas/NetworkTimelineAttempt' nullable: true description: Establert en esdeveniments `verification_attempt`. transaction: allOf: - $ref: '#/components/schemas/NetworkTimelineTransaction' nullable: true description: Establert en esdeveniments `transaction`. login: allOf: - $ref: '#/components/schemas/NetworkTimelineLogin' nullable: true description: Establert en esdeveniments `login`. rule_hit: allOf: - $ref: '#/components/schemas/NetworkTimelineRuleHit' nullable: true description: Establert en esdeveniments `rule_hit`. case_linked: allOf: - $ref: '#/components/schemas/NetworkTimelineCaseLinked' nullable: true description: Establert en esdeveniments `case_linked`. note_added: allOf: - $ref: '#/components/schemas/NetworkTimelineNoteAdded' nullable: true description: >- Establert en esdeveniments `note_added`. Mai es retorna a una clau d'API. NetworkTimelineAccount: type: object description: El compte de membre al qual pertany l'esdeveniment. properties: node_id: type: string description: >- `:`, on el tipus és `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` quan el registre pertany a l'aplicació que has cridat (per a un membre de la consola, a una aplicació a la qual se li ha concedit accés). `organization` quan pertany a una altra aplicació de la teva organització. route: $ref: '#/components/schemas/NetworkTimelineRoute' NetworkTimelineSourceRef: type: object description: El registre del qual s'ha llegit l'esdeveniment. 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` quan el registre pertany a l'aplicació que has cridat (per a un membre de la consola, a una aplicació a la qual se li ha concedit accés). `organization` quan pertany a una altra aplicació de la teva organització. route: allOf: - $ref: '#/components/schemas/NetworkTimelineRoute' description: Absent en `monitoring_event` i `case`. NetworkTimelineAttempt: type: object description: Una sessió de verificació del compte. properties: session_id: type: string format: uuid description: >- L'UUID de la sessió, o l'UUID de la sessió d'empresa per a una companyia. session_number: type: integer nullable: true attempt: type: integer description: >- La posició d'aquesta sessió entre les sessions del compte, per ordre de creació. attempt_count: type: integer description: Quantes sessions té el compte. status: type: string description: L'estat de la sessió, per exemple `Approved` o `Declined`. status_changed_at: type: string format: date-time nullable: true decline_reasons: type: array items: $ref: '#/components/schemas/NetworkTimelineDeclineReason' description: >- Només per a una sessió rebutjada: les seves advertències, de més antiga a més recent, una vegada per advertència. Buit en cas contrari. NetworkTimelineTransaction: type: object description: >- Una transacció en què ha participat un compte membre, datada per la seva data de transacció. 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: Nul quan la transacció no té cap import. status: type: string decision_reason_code: type: string nullable: true decision_reason_label: type: string nullable: true party_role: type: string description: >- El rol del compte a la transacció: `APPLICANT`, `REMITTER`, `BENEFICIARY` o `COUNTERPARTY`. NetworkTimelineLogin: type: object description: >- Un esdeveniment d'inici de sessió que has enviat per a una persona mitjançant l'API d'esdeveniments. properties: action: type: string description: >- `.`: `auth.login` o `security.login_succeeded` per a un inici de sessió, `auth.login_failed` o `security.login_failed` per a un inici de sessió fallit. succeeded: type: boolean status: type: string description: L'estat de l'esdeveniment. ip: allOf: - $ref: '#/components/schemas/NetworkTimelineIP' nullable: true description: Nul quan l'esdeveniment no té adreça IP. device: allOf: - $ref: '#/components/schemas/NetworkTimelineDevice' nullable: true description: >- Nul quan l'esdeveniment no té empremta digital de dispositiu ni context. is_first_login: type: boolean description: El primer inici de sessió satisfactori registrat del compte. is_new_device: type: boolean description: >- Un inici de sessió satisfactori des d'un dispositiu del qual no procedia cap dels inicis de sessió satisfactoris anteriors del compte. Mai és cert en el primer inici de sessió. NetworkTimelineRuleHit: type: object description: >- Una regla activa que ha coincidit amb una transacció o esdeveniment d'un membre. No s'inclouen les coincidències en mode de prova. 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 cas obert per a la xarxa a la teva organització. `source_ref.ownership` indica si pertany a l'aplicació que has cridat. 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 deixada a la xarxa. El text de la nota no s'inclou. properties: note_id: type: string format: uuid author_email: type: string NetworkTimelineRoute: type: object description: >- On s'obre el registre: el seu tipus, el seu UUID i l'aplicació a la qual pertany. properties: kind: type: string description: >- `user`, `business` o `transaction_party` per a un compte; `session`, `business_session` o `transaction` per a un registre d'origen. id: type: string format: uuid application_id: type: string format: uuid NetworkTimelineDeclineReason: type: object properties: risk: type: string description: El codi d'advertència. feature: type: string description: La funcionalitat que ha generat l'advertència. short_description: type: string NetworkTimelineAmount: type: object properties: value: type: string description: Quantitat decimal com a cadena de text. 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'etiqueta del tipus de connexió per a l'adreça, com a text lliure. 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: >- Una etiqueta de dispositiu llegible generada a partir del context de dispositiu de l'esdeveniment. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.