Saltar al contenido principal
GET
curl

Descripción general

Devuelve una única entidad de empresa identificada por vendor_data.

Cuándo usarlo

  • Consulta el estado de verificación actual de una empresa: el mapa features te muestra de un vistazo el estado más reciente de cada función de KYB.
  • Vistas de detalle en tu propia interfaz de administración.
  • Puntuación de riesgo a partir de los contadores agregados y los estados de las funciones.

Notas

  • vendor_data en la URL distingue entre mayúsculas y minúsculas.
  • Devuelve 404 si no existe ninguna empresa con ese vendor_data.
  • Los contadores agregados (session_count, approved_count, declined_count, in_review_count) se actualizan en tiempo real a medida que se completan las sesiones de Verificación de empresas (KYB).
  • Los campos obtenidos del registro (legal_name, registration_number, country_code) reflejan la sesión de Verificación de empresas (KYB) aprobada más reciente.

Permisos

El rol debe conceder read:businesses.

Relacionado

Autorizaciones

x-api-key
string
header
requerido

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.

Parámetros de ruta

vendor_data
string
requerido

Tu identificador único de la empresa: una cadena de texto libre (NO un UUID), que se compara exactamente tal como se envía.

Respuesta

Detalle completo de la empresa, incluidos los metadatos y los datos agregados de las sesiones.

Detalle completo de la empresa. Amplía BusinessListItem con los metadatos y updated_at.

didit_internal_id
string<uuid>

UUID interno estable de Didit para esta empresa.

vendor_data
string | null

Tu identificador único de esta empresa (el que se envía al crear sesiones). Puede ser null si no se proporcionó ningún identificador propio.

display_name
string | null

Nombre visible personalizado que has definido

Razón social oficial obtenida del registro o introducida manualmente

registration_number
string | null

Número de registro o de constitución de la empresa

country_code
string | null

País de constitución (ISO 3166-1 alfa-2, p. ej., GB, US).

effective_name
string | null

Mejor nombre disponible: display_name si está definido; si no, legal_name

status
enum<string>

Estado del ciclo de vida del registro de la empresa (NO es un estado de sesión). ACTIVE es el valor predeterminado, FLAGGED lo marca para atención manual y BLOCKED impide nuevas sesiones para este vendor_data.

Opciones disponibles:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Número total de sesiones de verificación de esta empresa

approved_count
integer

Número de sesiones aprobadas

declined_count
integer

Número de sesiones rechazadas

in_review_count
integer

Número de sesiones en revisión

features
object

Estado agregado por función de todas las sesiones KYB de esta empresa. Actualmente la única clave es KYB (el estado de la comprobación de la empresa en el registro). Valores posibles: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Los mismos datos que features, como un array ordenado de objetos {feature, status}.

last_session_at
string<date-time> | null

Marca de tiempo de la sesión más reciente

first_session_at
string<date-time> | null

Marca de tiempo de la primera sesión

last_activity_at
string<date-time> | null

Marca de tiempo de la actividad más reciente (cambio de estado, actualización de la sesión, etc.)

tags
object[]

Etiquetas asignadas a esta empresa

created_at
string<date-time>
metadata
object

JSON de metadatos personalizados que adjuntaste a esta empresa. Valor predeterminado: {}.

updated_at
string<date-time>
Última modificación el 1 de noviembre de 2026