CRUD de empresas (KYB): operaciones con la Management API

Toda la gestión de la entidad Business se realiza a través de seis endpoints públicos bajo /v3/businesses/. Esta página ofrece un recorrido conceptual; consulta la referencia de la API para ver los esquemas completos de solicitud y respuesta.

Listar empresas

GET /v3/businesses/ Lista paginada de las empresas de tu aplicación, con filtros por estado, búsqueda, país y rango de fechas.

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"

Obtener una empresa

GET /v3/businesses/{vendor_data}/ Obtiene una única empresa por vendor_data.

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

Crear una empresa

POST /v3/businesses/create/ Crea por adelantado una empresa antes de que se ejecute cualquier sesión de verificación de empresas (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" }
  }'

Devuelve un error de conflicto si ya existe una empresa con ese vendor_data. Usa PATCH para actualizar una empresa existente.

Actualizar una empresa

PATCH /v3/businesses/{vendor_data}/ Actualiza los campos modificables del perfil. Los campos obtenidos de consultas al registro (legal_name, registration_number, country_code) son de solo lectura tras la verificación, pero se pueden sobrescribir; las sobrescrituras quedan marcadas en el registro de auditoría. Campos modificables: display_name, metadata, tags. De solo lectura tras la verificación: todos los campos obtenidos del registro, los contadores agregados y el mapa 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" } }'

Emite business.data.updated.

Cambiar el estado

PATCH /v3/businesses/{vendor_data}/update-status/ Cambia el estado de una empresa entre ACTIVE, FLAGGED y 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"
  }'

De → a	Disparador habitual
`ACTIVE` → `FLAGGED`	Sesión de Verificación de empresas (KYB) pasa a `In Review`, coincidencia durante la monitorización continua de AML, regla de transacción
`ACTIVE` → `BLOCKED`	Sesión de Verificación de empresas (KYB) `Declined` con bloqueo automático, entidad sancionada confirmada
`FLAGGED` → `ACTIVE`	Un analista completó la revisión
`BLOCKED` → `ACTIVE`	Desbloqueo manual tras la remediación

Emite business.status.updated.

Eliminar empresas (por lotes)

POST /v3/businesses/delete/ Elimina una o varias empresas. Los registros de las empresas se eliminan de forma permanente. Sus sesiones de verificación no están cubiertas por este endpoint y se conservan, con su vínculo a la empresa eliminado; elimínalas con Delete Session. Las transacciones tampoco están cubiertas; elimínalas desde la consola.

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"] }'

Es idempotente: eliminar una empresa ya eliminada no tiene ningún efecto.

Modelo de permisos

Todos los endpoints /v3/businesses/* están sujetos al recurso de permisos businesses:

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

Consulta Roles y permisos.

Webhooks activados por estas operaciones

Operación	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` con `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` con `deleted_at` establecido

Próximos pasos

Modelo de datos

Referencia completa de los campos.

API de listado

Esquema de GET /v3/businesses/.

API de creación

Esquema de POST /v3/businesses/create/.

Última modificación el 1 de noviembre de 2026

Visión general

Precios

Flujos y verificación

Revisión y operaciones

Entidades (usuarios y empresas)

Ajustes y personalización

Seguridad y cumplimiento

Didit Academy

Recursos

CRUD de empresas (KYB): operaciones con la Management API

Listar empresas

Obtener una empresa

Crear una empresa

Actualizar una empresa

Cambiar el estado

Eliminar empresas (por lotes)

Modelo de permisos

Webhooks activados por estas operaciones

Próximos pasos

Modelo de datos

API de listado

API de creación

​Listar empresas

​Obtener una empresa

​Crear una empresa

​Actualizar una empresa

​Cambiar el estado

​Eliminar empresas (por lotes)

​Modelo de permisos

​Webhooks activados por estas operaciones

​Próximos pasos

Modelo de datos

API de listado

API de creación

Listar empresas

Obtener una empresa

Crear una empresa

Actualizar una empresa

Cambiar el estado

Eliminar empresas (por lotes)

Modelo de permisos

Webhooks activados por estas operaciones

Próximos pasos