Tienes el número de una sociedad británica, de una factura, un contrato o un formulario de alta, y quieres saber tres cosas antes de seguir: ¿existe?, ¿sigue en activo?, ¿hay abierto un procedimiento de insolvencia? Este tutorial lo hace con la API de Fuentio, paso a paso, con cURL, Python y JavaScript, a partir de respuestas reales registradas el 16 de octubre de 2026.
En resumen: consulta la sociedad con GET /v1/companies/GB/{número} (1 unidad), o verifícala con POST /v1/verifications y {"country": "GB", "identifier": "00445790"} (5 unidades). La verificación devuelve un resultado (verified o unverified) con sus motivos, cada comprobación realizada, la ficha de Companies House, sus procedimientos de insolvencia y un código de prueba que cualquiera puede comprobar después.
Lo que vas a aprender
- Cómo normalizar un número de sociedad británico antes de llamar a nada
- Cómo consultar una sociedad y leer su situación sin equivocarte
- Cómo verificarla y obtener un resultado, unos motivos y un código de prueba
- Cómo buscar por nombre cuando no tienes el número
- Cómo gestionar cada error, qué guardar y cuánto cuesta cada llamada
Paso 1: consigue una clave de API
Crea una clave gratuita con una sola petición (100 unidades al mes con el plan gratuito):
curl -X POST https://api.fuentio.com/v1/keys
Guárdala en una variable de entorno, nunca en tu código:
export FUENTIO_API_KEY="la clave que has recibido"
También puedes hacer algunas llamadas sin clave: la prueba sin clave da 20 unidades al día por dirección.
Paso 2: normaliza el número de sociedad
Un número de sociedad de Companies House tiene 8 caracteres: 8 cifras para la mayoría de las sociedades registradas en Inglaterra y Gales, completadas con ceros (00445790), o un prefijo de dos letras y 6 cifras, como SC para Escocia, NI para Irlanda del Norte y OC para una limited liability partnership. A diferencia del SIREN francés, no tiene dígito de control: una comprobación de formato detecta una longitud errónea o un carácter extraño, no una errata en las cifras.
Es habitual que se pierdan los ceros iniciales. Recupéralos antes de consultar nada:
import re
def company_number(raw: str) -> str | None:
n = re.sub(r"\s", "", raw).upper()
if n.isdigit() and len(n) <= 8:
n = n.zfill(8)
return n if re.fullmatch(r"[0-9]{8}|[A-Z]{2}[0-9]{6}", n) else None
print(company_number("445790")) # Tesco PLC: 00445790
print(company_number("sc 123456")) # SC123456
function companyNumber(raw) {
let n = raw.replace(/\s/g, "").toUpperCase();
if (/^\d{1,8}$/.test(n)) n = n.padStart(8, "0");
return /^(\d{8}|[A-Z]{2}\d{6})$/.test(n) ? n : null;
}
Un número que este patrón rechaza no es necesariamente falso, porque existen algunos formatos antiguos: pásalo a una persona en lugar de rechazarlo.
Paso 3: consulta la sociedad
Una petición, una unidad:
curl https://api.fuentio.com/v1/companies/GB/00445790 -H "Authorization: Bearer $FUENTIO_API_KEY"
Con Python (httpx):
import os, httpx
r = httpx.get("https://api.fuentio.com/v1/companies/GB/00445790",
headers={"Authorization": f"Bearer {os.environ['FUENTIO_API_KEY']}"})
company = r.json()["data"]
print(company["name"]["original"], company["status"]["original_label"])
Con JavaScript (fetch):
const res = await fetch("https://api.fuentio.com/v1/companies/GB/00445790", {
headers: { Authorization: `Bearer ${process.env.FUENTIO_API_KEY}` },
});
const { data, meta, error } = await res.json();
console.log(data.name.original, data.status.original_label);
Paso 4: lee la ficha, y su situación, con atención
Esta es una parte de la ficha que devolvió la API para Tesco PLC el 16 de octubre de 2026:
{
"id": "GB-COMPANYNUMBER-00445790",
"name": {"original": "TESCO PLC"},
"legal_form": {"original_code": "plc", "original_label": "Public Limited Company"},
"status": {"value": "active", "original_label": "Active", "as_of": null},
"incorporation_date": "1947-11-27",
"registered_address": {"street": "Tesco House, Shire Park, Kestrel Way", "postal_code": "AL7 1GA", "locality": "Welwyn Garden City", "country": "GB"},
"activity": {"original_scheme": "UK_SIC_2007", "original_code": "47110", "nace_rev2": "47.11"},
"provenance": {"source": "gb_companies_house_api", "source_url": "https://find-and-update.company-information.service.gov.uk/company/00445790"}
}
Lee la situación en dos partes. status.value es un valor normalizado; status.original_label es la palabra de Companies House. Pueden contar historias distintas. Para APPLETREE FARM CRESSING LIMITED (12401266), el mismo día, la API devolvió:
"status": {"value": "active", "original_label": "In Administration", "as_of": null,
"summary": "Still registered, but an insolvency procedure is open: administration"}
La sociedad sigue en el registro, así que value es active, pero hay un procedimiento de administración abierto. Un código que solo lee value lo pasa por alto. Lee también original_label y summary, o deja que decida la verificación del paso siguiente.
La procedencia lleva la mención de licencia de Companies House, la Open Government Licence v3.0. Consérvala con cualquier dato que transmitas.
Paso 5: verifica la sociedad y obtén un código de prueba
Una verificación hace las comprobaciones por ti y devuelve un resultado con sus motivos (5 unidades):
curl -X POST https://api.fuentio.com/v1/verifications -H "Authorization: Bearer $FUENTIO_API_KEY" \
-H "Content-Type: application/json" -d '{"country": "GB", "identifier": "00445790"}'
Para Tesco PLC, el resultado de la respuesta registrada:
"result": {"outcome": "verified", "reasons": ["company_active"],
"summary": "TESCO PLC (GB, Companies House company number 00445790): verified, active per Companies House Public Data API, checked 2026-10-16. Proof FUE-GB-20261016-5QBDT2."}
La lista checks muestra cada comprobación con su resultado. Para Tesco PLC hubo cinco, todas superadas: el formato del identificador, la ficha encontrada, la situación en el registro, una dirección publicada y la frescura de la copia. Para Appletree Farm Cressing hubo una sexta, no_open_insolvency, que falló, y el resultado la siguió:
"result": {"outcome": "unverified", "reasons": ["insolvency_administration"]},
"insolvency": {"state": "in_procedure", "procedure": "administration", "opened_on": "2023-10-05"}
El proof_code, por ejemplo FUE-GB-20261016-5QBDT2, permite a cualquiera comprobar después lo que respondió la API y cuándo, en la página pública de prueba o con GET /v1/public/proofs/{code}. Para el significado de cada situación de Companies House, consulta cómo comprobar la situación de una sociedad británica.
Paso 6: busca por nombre cuando no tienes el número
Una búsqueda por nombre cuesta 2 unidades y devuelve candidatos con su número de sociedad:
curl "https://api.fuentio.com/v1/companies/search?country=GB&q=tesco" -H "Authorization: Bearer $FUENTIO_API_KEY"
Muchas sociedades comparten palabras en su nombre. Enseña los candidatos a una persona, o pide a tu usuario el número de sociedad: un nombre es una etiqueta, un número es una identidad. Cuando tengas el número correcto, vuelve al paso 3 o al 5.
Paso 7: gestiona cada error
Los errores usan el mismo sobre, con un error.code de una lista cerrada y un hint con el siguiente paso:
invalid_identifier(400): el valor no es un número de sociedad. Gratis.not_found(404): un número bien formado sin ninguna sociedad detrás. Cuesta una unidad, porque es una respuesta real.rate_limited(429): demasiadas peticiones por segundo para tu plan. Espera los segundos que indica la cabeceraRetry-After.quota_exceeded(402): se han agotado tus unidades;error.detailsdice tu límite y cuándo se renueva.upstream_unavailable(503): Companies House no responde y no hay ninguna copia anterior que servir. Vuelve a intentarlo más tarde.
body = r.json()
if body["error"]:
print(body["error"]["code"], "-", body["error"]["hint"])
Paso 8: guarda la respuesta con tu expediente
Cuando alguien pregunte después cómo sabías que una sociedad estaba en activo, enseña la respuesta tal como era ese día. Guarda, junto a la ficha del cliente o del proveedor: el número de sociedad, el resultado y sus motivos, el proof_code, y los bloques provenance y freshness (fuente, enlace, licencia, cuándo se obtuvo la ficha). Las respuestas registradas indican la frescura de la copia: Fuentio reutiliza su copia de una ficha de Companies House durante 7 días como máximo y luego la vuelve a obtener, antes si lo pides con max_age.
¿Cuánto cuesta cada paso?
- Consulta por número de sociedad: 1 unidad.
- Verificación con resultado, motivos y código de prueba: 5 unidades.
- Búsqueda por nombre: 2 unidades.
- Un número no válido: gratis.
El mismo tutorial para Francia: cómo verificar una empresa francesa por API. Para hacer las mismas comprobaciones a mano, consulta cómo comprobar una sociedad británica en Companies House, y para lo que dice la forma de una sociedad, las formas jurídicas comparadas. Consulta los precios y lo que cubrimos.
Límites. Las respuestas mostradas se registraron con la API el 16 de octubre de 2026; la ficha de una sociedad cambia. No se sirve ningún nombre de persona: los administradores, las personas con control significativo y cualquier otra persona quedan fuera de cada respuesta. La verificación dice lo que contiene el registro; no es un KYB completo ni un cribado de sanciones, y la decisión que tomes con ella sigue siendo tuya.
Preguntas frecuentes
¿Tiene dígito de control un número de sociedad británico?
No. A diferencia del SIREN francés, no lo tiene: una comprobación local detecta un formato erróneo, no una errata en las cifras. La consulta dice si hay una sociedad detrás del número.
¿Por qué una sociedad activa sale sin verificar?
Porque la situación en el registro no lo dice todo. Una sociedad en administración sigue inscrita, así que su situación vale active, pero el procedimiento de insolvencia abierto hace que el resultado sea unverified, con el motivo insolvency_administration.
¿Qué diferencia hay entre una consulta y una verificación?
Una consulta (1 unidad) devuelve la ficha de la sociedad. Una verificación (5 unidades) hace las comprobaciones sobre esa ficha y devuelve un resultado, sus motivos, el estado de insolvencia y un código de prueba.
¿Puedo consultar una sociedad británica por su LEI?
Sí. La lista de cobertura de la API muestra dos tipos de identificador para el Reino Unido: el número de sociedad y el LEI.
Fuentes
- API de Fuentio, respuestas registradas para 00445790 y 12401266 (16 de octubre de 2026), y la lista de cobertura
GET /v1/countries(consultada el 22 de octubre de 2026) - Companies House, Find and update company information: find-and-update.company-information.service.gov.uk
- Companies House Public Data API: developer.company-information.service.gov.uk
- Open Government Licence v3.0: nationalarchives.gov.uk
