Vérifier une société britannique par API : numéro de société, statut, insolvabilité et code de preuve

Tutoriel : contrôler le format d’un numéro de société britannique, consulter la société, la vérifier avec un résultat et un code de preuve, gérer les erreurs.

· Par l’équipe Fuentio · 7 min de lecture

Image de partage : « Vérifier une société britannique par API : numéro de société, statut, insolvabilité et code de preuve » sur le fond papier de Fuentio, avec l’étiquette Tutoriel.

Vous avez le numéro d’une société britannique, sur une facture, un contrat ou un formulaire d’inscription, et vous voulez savoir trois choses avant d’aller plus loin : existe-t-elle, est-elle toujours en activité, une procédure d’insolvabilité est-elle ouverte ? Ce tutoriel le fait avec l’API Fuentio, étape par étape, en cURL, Python et JavaScript, à partir de vraies réponses enregistrées le 16 octobre 2026.

En bref : consultez la société avec GET /v1/companies/GB/{numéro} (1 unité), ou vérifiez-la avec POST /v1/verifications et {"country": "GB", "identifier": "00445790"} (5 unités). La vérification renvoie un résultat (verified ou unverified) avec ses raisons, chaque contrôle effectué, la fiche de Companies House, ses procédures d’insolvabilité et un code de preuve que chacun peut contrôler plus tard.

Ce que vous allez apprendre

  • Comment normaliser un numéro de société britannique avant tout appel
  • Comment consulter une société, et lire son statut sans vous tromper
  • Comment la vérifier et obtenir un résultat, des raisons et un code de preuve
  • Comment chercher par nom quand vous n’avez pas de numéro
  • Comment gérer chaque erreur, quoi garder, et ce que coûte chaque appel

Étape 1 : obtenir une clé d’API

Créez une clé gratuite en une requête (100 unités par mois avec l’offre gratuite) :

curl -X POST https://api.fuentio.com/v1/keys

Gardez-la dans une variable d’environnement, jamais dans votre code :

export FUENTIO_API_KEY="la clé reçue"

Vous pouvez aussi faire quelques appels sans clé : l’essai sans clé donne 20 unités par jour et par adresse.

Étape 2 : normaliser le numéro de société

Un numéro de société de Companies House compte 8 caractères : 8 chiffres pour la plupart des sociétés immatriculées en Angleterre et au pays de Galles, complétés par des zéros (00445790), ou un préfixe de deux lettres suivi de 6 chiffres, comme SC pour l’Écosse, NI pour l’Irlande du Nord et OC pour une limited liability partnership. Contrairement au SIREN, il n’a pas de chiffre de contrôle : un contrôle de format repère une longueur fausse ou un caractère parasite, pas une faute de frappe dans les chiffres.

Les zéros initiaux sont souvent oubliés. Remettez-les avant toute consultation :

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 numéro que ce motif rejette n’est pas forcément faux, car quelques formats plus anciens existent : transmettez-le à une personne plutôt que de le refuser.

Étape 3 : consulter la société

Une requête, une unité :

curl https://api.fuentio.com/v1/companies/GB/00445790 -H "Authorization: Bearer $FUENTIO_API_KEY"

Avec 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"])

Avec 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);

Étape 4 : lire la fiche, et son statut, avec attention

Voici une partie de la fiche que l’API a renvoyée pour Tesco PLC le 16 octobre 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"}
}

Lisez le statut en deux temps. status.value est une valeur normalisée ; status.original_label est le mot de Companies House. Ils peuvent raconter deux histoires différentes. Pour APPLETREE FARM CRESSING LIMITED (12401266), le même jour, l’API a renvoyé :

"status": {"value": "active", "original_label": "In Administration", "as_of": null,
           "summary": "Still registered, but an insolvency procedure is open: administration"}

La société est toujours au registre, donc value vaut active, mais une procédure d’administration est ouverte. Un code qui ne lit que value passe à côté. Lisez aussi original_label et summary, ou laissez la vérification de l’étape suivante trancher.

La provenance porte la mention de licence de Companies House, l’Open Government Licence v3.0. Gardez-la avec toute donnée que vous transmettez.

Étape 5 : vérifier la société et obtenir un code de preuve

Une vérification fait les contrôles pour vous et renvoie un résultat avec ses raisons (5 unités) :

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

Pour Tesco PLC, le résultat de la réponse enregistrée :

"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 liste checks montre chaque contrôle avec son résultat. Pour Tesco PLC, il y en avait cinq, tous réussis : le format de l’identifiant, la fiche trouvée, le statut au registre, une adresse publiée et la fraîcheur de la copie. Pour Appletree Farm Cressing, il y en avait un sixième, no_open_insolvency, qui a échoué, et le résultat a suivi :

"result": {"outcome": "unverified", "reasons": ["insolvency_administration"]},
"insolvency": {"state": "in_procedure", "procedure": "administration", "opened_on": "2023-10-05"}

Le proof_code, par exemple FUE-GB-20261016-5QBDT2, permet à chacun de contrôler plus tard ce que l’API a répondu et quand, sur la page publique de preuve ou avec GET /v1/public/proofs/{code}. Pour le sens de chaque statut de Companies House, voir comment lire le statut d’une société britannique.

Étape 6 : chercher par nom quand vous n’avez pas de numéro

Une recherche par nom coûte 2 unités et renvoie des candidats avec leur numéro de société :

curl "https://api.fuentio.com/v1/companies/search?country=GB&q=tesco" -H "Authorization: Bearer $FUENTIO_API_KEY"

Beaucoup de sociétés partagent des mots dans leur nom. Montrez les candidats à une personne, ou demandez le numéro de société à votre utilisateur : un nom est une étiquette, un numéro est une identité. Une fois le bon numéro trouvé, revenez à l’étape 3 ou 5.

Étape 7 : gérer chaque erreur

Les erreurs ont la même enveloppe, avec un error.code pris dans une liste fermée et un hint pour la suite :

  • invalid_identifier (400) : la valeur n’est pas un numéro de société. Gratuit.
  • not_found (404) : un numéro bien formé derrière lequel il n’y a pas de société. Il coûte une unité, parce que c’est une vraie réponse.
  • rate_limited (429) : trop de requêtes par seconde pour votre offre. Attendez le nombre de secondes indiqué dans l’en-tête Retry-After.
  • quota_exceeded (402) : vos unités sont épuisées ; error.details donne votre limite et sa date de remise à zéro.
  • upstream_unavailable (503) : Companies House ne répond pas et il n’y a pas de copie antérieure à servir. Réessayez plus tard.
body = r.json()
if body["error"]:
    print(body["error"]["code"], "-", body["error"]["hint"])

Étape 8 : garder la réponse avec votre dossier

Quand on vous demandera plus tard comment vous saviez qu’une société était en activité, montrez la réponse telle qu’elle était ce jour-là. Gardez, à côté de votre fiche client ou fournisseur : le numéro de société, le résultat et ses raisons, le proof_code, et les blocs provenance et freshness (source, lien, licence, date de récupération de la fiche). Les réponses enregistrées disent la fraîcheur de la copie : Fuentio réutilise sa copie d’une fiche de Companies House pendant 7 jours au plus, puis la récupère à nouveau, plus tôt si vous le demandez avec max_age.

Que coûte chaque étape ?

  • Consultation par numéro de société : 1 unité.
  • Vérification avec un résultat, des raisons et un code de preuve : 5 unités.
  • Recherche par nom : 2 unités.
  • Un numéro invalide : gratuit.

Le même tutoriel pour la France : comment vérifier une entreprise française par API. Pour faire les mêmes contrôles à la main, voir comment vérifier une société britannique avec Companies House, et pour ce que dit la forme d’une société, les formes juridiques comparées. Voyez les tarifs et ce que nous couvrons.

Questions fréquentes

Un numéro de société britannique a-t-il un chiffre de contrôle ?

Non. Contrairement au SIREN, il n’en a pas : un contrôle local repère un mauvais format, pas une faute de frappe dans les chiffres. La consultation dit s’il existe une société derrière le numéro.

Pourquoi une société active ressort-elle non vérifiée ?

Parce que le statut au registre ne dit pas tout. Une société en administration est toujours inscrite, donc son statut vaut active, mais la procédure d’insolvabilité ouverte rend le résultat non vérifié, avec la raison insolvency_administration.

Quelle différence entre une consultation et une vérification ?

Une consultation (1 unité) renvoie la fiche de la société. Une vérification (5 unités) fait les contrôles sur cette fiche et renvoie un résultat, ses raisons, l’état d’insolvabilité et un code de preuve.

Peut-on consulter une société britannique par son LEI ?

Oui. La liste de couverture de l’API indique deux types d’identifiants pour le Royaume-Uni : le numéro de société et le LEI.

Sources

← Tous les articles · Flux RSS