Verificación empresarial en España (KYB)

Este endpoint está pensado para equipos que deben saber con quién contratan: bancos, plataformas B2B, insuretech, operadores de marketplace o cualquier negocio que deba validar que una empresa existe, está activa y coincide con el identificador que te ha proporcionado el usuario o el fichero de alta.

Qué hace en la práctica: envías un identificador de empresa (por ejemplo CIF/NIF en el formato que admita el servicio) y recibes un objeto de datos que puedes usar para completar fichas de cliente, pipelines de aprobación o revisiones de cumplimiento. La respuesta incluye firma Verifik para trazabilidad. Los campos exactos dependen de la fuente y de tu configuración; si necesitas un listado campo a campo para tu sector, el equipo de soporte puede orientarte.

Cuándo tiene sentido usarlo: alta de proveedores, revisión previa a pagos recurrentes, apertura de cuentas corporativas, verificación de titulares reales en operaciones sensibles, o cualquier flujo KYB donde “la empresa es quien dice ser” sea un requisito previo a seguir adelante.

Limitaciones y buenas prácticas: no sustituye un informe legal completo ni una auditoría contable; es una capa de verificación automatizada encadenada a tu política interna. Asegúrate de manejar tokens de forma segura, de registrar intentos fallidos (empresa no encontrada) y de informar al usuario final cuando los datos no basten para una decisión automática.

Referencia de API

Endpoint

https://api.verifik.co/v2/es/company

Consulta de datos de empresa en España por identificador fiscal (por ejemplo CIF). La respuesta te ayuda en KYB y due diligence: confirmar que la entidad existe y alinear razón social o estado con tu política de contratación de proveedores o clientes B2B. No reemplaza un informe legal o auditoría contable; sí automatiza el paso previo de “¿esta empresa es quien dice ser?” en tiempo de solicitud. Si el identificador no existe o es inválido, maneja el error según la tabla de respuestas.

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentNumber	string	Sí	Identificador fiscal de la empresa (p. ej. CIF).

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/es/company", {
  params: { documentNumber: "B12345678" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/es/company");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Accept: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
    "documentNumber" => "B12345678"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/es/company?".$query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

url = "https://api.verifik.co/v2/es/company"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "B12345678"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Go

package main

import (
    "fmt"
    "net/http"
)

func main() {
    url := "https://api.verifik.co/v2/es/company?documentNumber=B12345678"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Authorization", "Bearer "+getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    fmt.Println(resp.Status)
}

Respuesta

200

{
  "data": {
    "documentNumber": "B12345678",
    "companyName": "Empresa España S.L.",
    "status": "active"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
  "id": "ESCO1"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

401

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

500

{
    "code": "InternalServerError",
    "message": "Server error."
}

Notas

• Contacta al soporte para el listado completo de campos del dataset según tu plan y sector.
• Si la empresa no existe en la fuente o el identificador es incorrecto, recibirás un error coherente con la tabla de respuestas; no asumas éxito sin comprobar el código HTTP y el cuerpo de la respuesta.