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_list": ["company-123", "company-456"]}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.businesses.batch_delete(
vendor_data_list=["company-123", "company-456"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.businesses.batchDelete({
vendor_data_list: ["company-123", "company-456"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Businesses.BatchDelete(ctx, didit.BusinessesBatchDeleteParams{
VendorDataList: didit.Some([]string{"company-123", "company-456"}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.BusinessesBatchDeleteParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.businesses().batchDelete(BusinessesBatchDeleteParams.builder()
.vendorDataList(List.of("company-123", "company-456"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->businesses->batchDelete([
'vendor_data_list' => ['company-123', 'company-456'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.businesses.batch_delete(vendor_data_list: ["company-123", "company-456"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Businesses.BatchDeleteAsync(new BusinessesBatchDeleteParams
{
VendorDataList = new string[] { "company-123", "company-456" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"deleted": 2
}API para eliminar empresas en lote: borrado de KYB
Elimina en lote entidades de empresa (KYB) de Didit usando vendor_data o didit_internal_id como identificador. Cumple con GDPR y CCPA.
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_list": ["company-123", "company-456"]}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.businesses.batch_delete(
vendor_data_list=["company-123", "company-456"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.businesses.batchDelete({
vendor_data_list: ["company-123", "company-456"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Businesses.BatchDelete(ctx, didit.BusinessesBatchDeleteParams{
VendorDataList: didit.Some([]string{"company-123", "company-456"}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.BusinessesBatchDeleteParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.businesses().batchDelete(BusinessesBatchDeleteParams.builder()
.vendorDataList(List.of("company-123", "company-456"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->businesses->batchDelete([
'vendor_data_list' => ['company-123', 'company-456'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.businesses.batch_delete(vendor_data_list: ["company-123", "company-456"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Businesses.BatchDeleteAsync(new BusinessesBatchDeleteParams
{
VendorDataList = new string[] { "company-123", "company-456" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"deleted": 2
}Descripción general
Elimina una o varias entidades comerciales. Los registros de las empresas se eliminan de forma permanente. Este endpoint no abarca las sesiones de Verificación de empresas (KYB), que se conservan con su vínculo a la empresa eliminado; para eliminarlas, usa Eliminar sesión. Tampoco abarca las transacciones; para eliminarlas, usa Eliminar transacciones en lote.Cuándo usarlo
- Solicitudes de derecho al olvido.
- Limpieza de empresas de prueba durante el control de calidad.
- Baja de empresas eliminadas de tu propia plataforma.
Notas
- Acepta una lista de valores de
vendor_datao dedidit_internal_id. - Es idempotente: eliminar una empresa ya eliminada no tiene ningún efecto.
- Devuelve solo el número de elementos eliminados, no un informe por elemento. Los valores que no coinciden con nada se omiten sin aviso.
- Emite
business.data.updatedcondeleted_atestablecido. - Los registros que pertenecen a la propia entidad de empresa se eliminan con ella: sus vínculos con etiquetas, su historial de comentarios y sus propios registros de dispositivo y de red.
- Los registros generados por una sesión KYB NO se eliminan: los datos del registro de empresas, los documentos subidos, las coincidencias AML, los beneficiarios finales y las comprobaciones de personas clave pertenecen a la sesión y se conservan hasta que elimines la propia sesión.
Datos en un informe regulatorio finalizado
Si alguna de las empresas seleccionadas forma parte de un caso con un informe regulatorio finalizado, toda la solicitud responde con409 y no se elimina nada. La respuesta usa code: in_filed_report e indica cada informe:
{
"detail": "A case about this person or company has a filed regulatory report, so it cannot be deleted.",
"code": "in_filed_report",
"reports": [
{
"uuid": "5ec00000-0000-4000-8000-000000000007",
"report_number": "SAR-0001",
"report_type": "SAR",
"case_uuid": "c1a5e000-0000-4000-8000-000000000001"
}
]
}
Permisos
El rol debe concederdelete:businesses. Normalmente se reserva para OWNER y ADMIN.
Relacionado
Autorizaciones
La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.
Cuerpo
Proporciona vendor_data_list, didit_internal_id_list o delete_all: true. Precedencia cuando se envían varios: delete_all > vendor_data_list > didit_internal_id_list (solo se usa el selector de mayor precedencia).
Tus propios identificadores que se van a eliminar, comparados exactamente como se enviaron.
UUID internos de Didit (didit_internal_id) que se van a eliminar.
Si es true, elimina todas las empresas de la aplicación. No se puede combinar con los selectores de lista.
Respuesta
Empresas eliminadas. Devuelve el número de filas eliminadas realmente.
Número de empresas eliminadas (excluye los valores de vendor_data que no coincidieron con nada).