Documentation API

APIs REST HubActiva

15 APIs pour les développeurs — validation, enrichissement, génération. Gratuit pour commencer, scalable pour la production.

HubActiva expose 15 APIs REST couvrant la validation IBAN (80+ pays), la vérification SIRET/SIREN via l'INSEE, la validation TVA intracommunautaire via VIES, la génération de factures Factur-X, le calcul d'empreinte carbone (facteurs ADEME), et 10 autres services. Toutes les APIs sont accessibles via RapidAPI avec un plan gratuit.

Base URL

https://hubactiva.pro/api/v1/

15

APIs disponibles

50+

Endpoints

Gratuit

Pour commencer

99.9%

Uptime garanti

Authentification requise

Toutes les requêtes doivent inclure les headers X-RapidAPI-Key et X-RapidAPI-Host. Obtenez votre clé gratuitement sur RapidAPI →

France Business

APIs spécialisées pour les données d'entreprises françaises, la fiscalité et les documents légaux.

SIREN / SIRET

/api/v1/siren

Recherche et vérification d'entreprises françaises via l'API INSEE — raison sociale, adresse, NAF, statut.

Méthode Endpoint
GET /?number=44306184100047
GET /search?q=hubactiva
POST /batch
JavaScript — fetch SIREN
// Rechercher une entreprise par son numéro SIREN/SIRET
const response = await fetch(
  'https://hubactiva.pro/api/v1/siren?number=44306184100047',
  {
    headers: {
      'X-RapidAPI-Key': 'VOTRE_CLE_API',
      'X-RapidAPI-Host': 'hubactiva.pro'
    }
  }
);

const data = await response.json();
// { siret: "44306184100047", denomination: "...", adresse: "...",
//   code_naf: "62.01Z", statut: "active", ... }
console.log(data.denomination); // Raison sociale
Disponible sur RapidAPI →

VAT — TVA Intracommunautaire

/api/v1/vat

Validation de numéros TVA intracommunautaires via le système VIES de la Commission Européenne.

Méthode Endpoint
GET /?number=FR12345678901
POST /batch
JavaScript — validation TVA
// Valider un numéro TVA intracommunautaire
const response = await fetch(
  'https://hubactiva.pro/api/v1/vat?number=FR40303265045',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { valid: true, country_code: "FR", country_name: "France",
//   company_name: "...", company_address: "...", vies_valid: true }
if (data.valid) console.log('TVA valide :', data.company_name);

Jours Fériés

/api/v1/jours-feries

Jours fériés français par année et région, incluant les DOM-TOM et territoires d'outre-mer.

Régions supportées : metropole, alsace-moselle, guadeloupe, guyane, martinique, mayotte, reunion, polynesie, nouvelle-caledonie, wallis-et-futuna, saint-pierre-et-miquelon, saint-barthelemy, saint-martin

Méthode Endpoint
GET /?year=2026®ion=metropole
GET /is-holiday?date=2026-05-01
GET /business-days?start=...&end=...
JavaScript — jours fériés 2026
// Récupérer les jours fériés 2026 en métropole
const response = await fetch(
  'https://hubactiva.pro/api/v1/jours-feries?year=2026®ion=metropole',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const { holidays } = await response.json();
// [{ date: "2026-01-01", name: "Jour de l'an" }, ...]
holidays.forEach(h => console.log(h.date, h.name));

NAF / APE

/api/v1/naf

Codes NAF/APE et nomenclature INSEE — recherche, détail de section, libellé officiel.

Méthode Endpoint
GET /?code=62.01Z
GET /search?q=développement
GET /sections
GET /section/{code}
JavaScript — lookup code NAF
// Récupérer le libellé d'un code NAF
const response = await fetch(
  'https://hubactiva.pro/api/v1/naf?code=62.01Z',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { code: "62.01Z", label: "Programmation informatique",
//   section: "J", section_label: "Information et communication" }

Factur-X

/api/v1/facturx

Génération de factures électroniques Factur-X (PDF/A-3 + XML embarqué) conformes à la norme EN 16931.

Méthode Endpoint
POST /generate
POST /validate
GET /profiles
JavaScript — générer une facture Factur-X
// Générer une facture Factur-X EN 16931
const response = await fetch('https://hubactiva.pro/api/v1/facturx/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-RapidAPI-Key': 'VOTRE_CLE_API',
    'X-RapidAPI-Host': 'hubactiva.pro'
  },
  body: JSON.stringify({
    profile: 'EN16931',
    seller: { name: 'Ma Société SAS', siret: '12345678900012', vat: 'FR12345678901' },
    buyer: { name: 'Client SARL', vat: 'FR98765432101' },
    invoice_number: 'FA-2026-0042',
    date: '2026-03-19',
    lines: [{ description: 'Prestation de conseil', quantity: 1, unit_price: 1500, vat_rate: 20 }]
  })
});

// Retourne un PDF/A-3 avec XML Factur-X embarqué
const blob = await response.blob();

Validation & Vérification

APIs de validation pour les données financières, les contacts et les informations d'entreprises.

IBAN

/api/v1/iban 80+ pays

Validation IBAN complète : format, checksum, identification bancaire (BIC/SWIFT), formatage électronique et papier.

Méthode Endpoint
GET /validate?iban=FR763000...
GET /format?iban=FR763000...
GET /generate?country=FR&bban=...
GET /bic?bic=BNPAFRPP
JavaScript — validation IBAN
// Valider un IBAN français
const iban = 'FR7630006000011234567890189';
const response = await fetch(
  `https://hubactiva.pro/api/v1/iban/validate?iban=${iban}`,
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { valid: true, country: "FR", bank_code: "30006",
//   bank_name: "Caisse d'Épargne", bic: "CEPAFRPP", ... }
if (data.valid) console.log('Banque :', data.bank_name);

Email

/api/v1/email

Validation d'adresses email : format, enregistrement MX, détection des adresses jetables (disposable).

Méthode Endpoint
GET /validate?email=user@ex.com
POST /validate/bulk
GET /disposable?email=...
GET /disposable/domain?domain=...
GET /disposable/stats
JavaScript — validation email
// Valider une adresse email avant inscription
const response = await fetch(
  'https://hubactiva.pro/api/v1/email/validate?email=contact@hubactiva.pro',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { valid: true, format_valid: true, mx_valid: true,
//   disposable: false, domain: "hubactiva.pro" }

Phone

/api/v1/phone

Validation et formatage de numéros de téléphone internationaux — type (mobile/fixe/VoIP), région, opérateur.

Retourne : valid, type (mobile/fixe/VoIP), region, carrier_type, formats (E.164, international, national), country_info, prefix_info

Méthode Endpoint
GET /?number=+33612345678
POST /batch
JavaScript — validation téléphone
// Valider et identifier un numéro de téléphone
const response = await fetch(
  'https://hubactiva.pro/api/v1/phone?number=0612345678',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { valid: true, type: "mobile", region: "France",
//   formats: { e164: "+33612345678", international: "+33 6 12 34 56 78",
//              national: "06 12 34 56 78" } }

Enrich

/api/v1/enrich

Enrichissement de données entreprise depuis un domaine ou une adresse email — informations firmographiques.

Méthode Endpoint
GET /domain?domain=hubactiva.pro
GET /email?email=contact@co.com
GET /status
JavaScript — enrichissement entreprise
// Enrichir les données d'une entreprise depuis son domaine
const response = await fetch(
  'https://hubactiva.pro/api/v1/enrich/domain?domain=hubactiva.pro',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { company_name: "HubActiva", industry: "SaaS",
//   employees: "1-10", country: "FR", founded: 2025 }

Génération de contenu

APIs de génération pour les codes-barres, QR codes, PDF et captures d'écran.

Barcode

/api/v1/barcode

Recherche et identification de produits par code-barres (EAN-13, UPC) — données produit, marque, catégorie.

Méthode Endpoint
GET /{code}
GET /search?q=nutella
POST /batch
JavaScript — lookup code-barres
// Identifier un produit depuis son code-barres EAN-13
const response = await fetch(
  'https://hubactiva.pro/api/v1/barcode/3017624010701',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { barcode: "3017624010701", name: "Nutella",
//   brand: "Ferrero", category: "Confiseries", weight: "400g" }
console.log(data.name, '—', data.brand);

QR Code

/api/v1/qrcode

Génération de QR codes en PNG ou SVG avec options de personnalisation (couleurs, taille, marges).

Options : format (png/svg), width, margin, color, backgroundColor

Méthode Endpoint
POST /generate
POST /bulk
GET /status
JavaScript — générer un QR code
// Générer un QR code PNG 300×300 pixels
const response = await fetch('https://hubactiva.pro/api/v1/qrcode/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-RapidAPI-Key': 'VOTRE_CLE_API',
    'X-RapidAPI-Host': 'hubactiva.pro'
  },
  body: JSON.stringify({
    data: 'https://hubactiva.pro',
    options: { format: 'png', width: 300, margin: 2, color: '#4f46e5' }
  })
});

// Retourne une image PNG binaire (image/png)
const blob = await response.blob();
const url = URL.createObjectURL(blob);

PDF

/api/v1/pdf

Génération de PDF depuis du HTML ou une URL — format A4/Letter, orientation, marges, en-têtes/pieds de page.

Méthode Endpoint
POST /from-html
POST /from-url
GET /status
JavaScript — générer un PDF depuis une URL
// Générer un PDF A4 depuis une URL
const response = await fetch('https://hubactiva.pro/api/v1/pdf/from-url', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-RapidAPI-Key': 'VOTRE_CLE_API',
    'X-RapidAPI-Host': 'hubactiva.pro'
  },
  body: JSON.stringify({
    url: 'https://example.com',
    format: 'A4',
    orientation: 'portrait',
    margin: { top: '20mm', bottom: '20mm', left: '15mm', right: '15mm' }
  })
});

// Retourne un fichier PDF binaire (application/pdf)
const blob = await response.blob();

Screenshot

/api/v1/screenshot

Capture de pages web en image (PNG, JPEG, WebP) — dimensions personnalisables, capture complète ou viewport.

Options : url, width, height, fullPage, format (png/jpeg/webp)

Méthode Endpoint
POST /capture
GET /status
JavaScript — capture de page web
// Capturer une page web en PNG pleine hauteur
const response = await fetch('https://hubactiva.pro/api/v1/screenshot/capture', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-RapidAPI-Key': 'VOTRE_CLE_API',
    'X-RapidAPI-Host': 'hubactiva.pro'
  },
  body: JSON.stringify({
    url: 'https://hubactiva.pro',
    width: 1280,
    fullPage: true,
    format: 'png'
  })
});

// Retourne une image PNG binaire (image/png)
const blob = await response.blob();

Données & Calcul

APIs utilitaires pour la conversion de devises et le calcul d'empreinte carbone.

Currency

/api/v1/currency

Taux de change en temps réel, conversion de devises et taux historiques pour toutes les devises mondiales.

Méthode Endpoint
GET /convert?from=EUR&to=USD&amount=100
GET /currencies
GET /history?from=EUR&to=USD&date=...
GET /rates?base=EUR
JavaScript — conversion de devises
// Convertir 100 EUR en USD au taux actuel
const response = await fetch(
  'https://hubactiva.pro/api/v1/currency/convert?from=EUR&to=USD&amount=100',
  { headers: { 'X-RapidAPI-Key': 'VOTRE_CLE_API', 'X-RapidAPI-Host': 'hubactiva.pro' } }
);

const data = await response.json();
// { from: "EUR", to: "USD", amount: 100, result: 108.42,
//   rate: 1.0842, timestamp: "2026-03-19T15:50:00Z" }
console.log(`100 EUR = ${data.result} USD`);

Carbon

/api/v1/carbon Facteurs ADEME

Calcul d'empreinte carbone avec les facteurs d'émission officiels ADEME — transport, énergie, alimentation.

Méthode Endpoint
POST /transport
POST /energy
POST /food
GET /factors
JavaScript — calcul empreinte carbone transport
// Calculer les émissions CO₂ d'un trajet en voiture
const response = await fetch('https://hubactiva.pro/api/v1/carbon/transport', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-RapidAPI-Key': 'VOTRE_CLE_API',
    'X-RapidAPI-Host': 'hubactiva.pro'
  },
  body: JSON.stringify({
    mode: 'car',
    distance_km: 100,
    passengers: 1
  })
});

const data = await response.json();
// { co2_kg: 18.5, co2_g_per_km: 185, mode: "car",
//   source: "ADEME Base Carbone 2024" }
console.log(`Émissions : ${data.co2_kg} kg CO₂`);

Questions fréquentes

Tout ce que vous devez savoir avant d'intégrer les APIs HubActiva.

Oui, toutes les APIs proposent un plan gratuit avec un quota mensuel suffisant pour le développement et les tests. Des plans payants sont disponibles pour les usages en production via RapidAPI.
Inscrivez-vous gratuitement sur RapidAPI, recherchez HubActiva, et abonnez-vous au plan gratuit. Votre clé API (X-RapidAPI-Key) est générée automatiquement.
La base URL est https://hubactiva.pro/api/v1/. Toutes les requêtes passent par RapidAPI qui gère l'authentification et le rate limiting.
Oui. Les APIs de validation (IBAN, email, phone) ne stockent aucune donnée. Les requêtes sont traitées en temps réel et aucune information personnelle n'est conservée sur les serveurs HubActiva.
Toutes les APIs retournent du JSON (application/json). Les APIs de génération (QR Code, PDF, Screenshot, Barcode) retournent des fichiers binaires (image/png, application/pdf) avec des métadonnées JSON.

Prêt à intégrer les APIs HubActiva ?

Plan gratuit disponible immédiatement. Pas de carte bancaire requise. Accès à toutes les 15 APIs.