Gestione aziende KYB: operazioni CRUD via API Didit

Tutta la gestione delle entità aziendali avviene tramite sei endpoint pubblici sotto /v3/businesses/. Questa pagina offre una panoramica concettuale; consulta il riferimento API per gli schemi completi di richiesta e risposta.

Elenco delle aziende

GET /v3/businesses/ Elenco paginato delle aziende della tua applicazione, con filtri per stato, ricerca, paese e intervallo di date.

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

Recupero di un’azienda

GET /v3/businesses/{vendor_data}/ Recupera una singola azienda tramite vendor_data.

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

Creazione di un’azienda

POST /v3/businesses/create/ Crea in anticipo un’azienda prima che venga avviata una sessione di Verifica aziendale (KYB):

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

Restituisce un errore di conflitto se esiste già un’azienda con quel vendor_data. Usa PATCH per aggiornare un’azienda esistente.

Aggiornamento di un’azienda

PATCH /v3/businesses/{vendor_data}/ Aggiorna i campi del profilo modificabili. I campi ricavati dalle ricerche nel registro delle imprese (legal_name, registration_number, country_code) sono di sola lettura dopo la verifica, ma possono essere sovrascritti: le sovrascritture vengono segnalate nel registro di audit. Campi modificabili: display_name, metadata, tags. Di sola lettura dopo la verifica: tutti i campi ricavati dal registro, i contatori aggregati, la mappa features.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

Invia l’evento webhook business.data.updated.

Modifica dello stato

PATCH /v3/businesses/{vendor_data}/update-status/ Sposta un’azienda tra ACTIVE, FLAGGED e BLOCKED.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

Da → a	Trigger comune
`ACTIVE` → `FLAGGED`	Sessione di Verifica aziendale (KYB) passata a `In Review`, riscontro nel monitoraggio AML continuo, regola sulle transazioni
`ACTIVE` → `BLOCKED`	Entità sanzionata confermata, inserimento manuale in blocklist
`FLAGGED` → `ACTIVE`	L’analista ha chiuso la revisione
`BLOCKED` → `ACTIVE`	Sblocco manuale dopo la rimozione del problema

Invia l’evento webhook business.status.updated.

Eliminazione di aziende (batch)

POST /v3/businesses/delete/ Elimina una o più aziende. I record delle aziende vengono rimossi in modo permanente. Le relative sessioni di verifica non sono coperte da questo endpoint e restano, con il collegamento all’azienda rimosso; eliminale con Elimina sessione. Anche le transazioni non sono coperte: eliminale dalla Console.

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

Idempotente: eliminare un’azienda già eliminata non produce alcun effetto.

Modello dei permessi

Tutti gli endpoint /v3/businesses/* sono limitati dalla risorsa di autorizzazione businesses:

Ruolo	list	get	create	update	update-status	delete
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

Vedi Ruoli e permessi.

Webhook inviati da queste operazioni

Operazione	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` con `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` con `deleted_at` valorizzato

Prossimi passi

Modello dei dati

Riferimento completo dei campi.

API di elenco

Schema di GET /v3/businesses/.

API di creazione

Schema di POST /v3/businesses/create/.

Ultima modifica il 7 novembre 2026

Panoramica

Prezzi

Workflow e verifica

Revisione e operazioni

Entità (utenti e aziende)

Impostazioni e personalizzazione

Sicurezza e compliance

Didit Academy

Risorse

Gestione aziende KYB: operazioni CRUD via API Didit

Elenco delle aziende

Recupero di un’azienda

Creazione di un’azienda

Aggiornamento di un’azienda

Modifica dello stato

Eliminazione di aziende (batch)

Modello dei permessi

Webhook inviati da queste operazioni

Prossimi passi

Modello dei dati

API di elenco

API di creazione

​Elenco delle aziende

​Recupero di un’azienda

​Creazione di un’azienda

​Aggiornamento di un’azienda

​Modifica dello stato

​Eliminazione di aziende (batch)

​Modello dei permessi

​Webhook inviati da queste operazioni

​Prossimi passi

Modello dei dati

API di elenco

API di creazione

Elenco delle aziende

Recupero di un’azienda

Creazione di un’azienda

Aggiornamento di un’azienda

Modifica dello stato

Eliminazione di aziende (batch)

Modello dei permessi

Webhook inviati da queste operazioni

Prossimi passi