Une société nouvellement constituée, un nouveau nom, un siège déménagé ou une dissolution en attente indiquent souvent qu’il est temps d’appeler, ou de resserrer le crédit. L’API surveille les comptes de votre CRM, vous envoie le changement tel qu’il apparaît au registre de Corporations Canada et liste les sociétés constituées cette semaine. Elle ne couvre que les sociétés fédérales : ni le REQ ni les autres registres provinciaux.
Ce sont des événements de changement du registre, pas des avis d’une gazette. Chacun est daté du jour où le changement apparaît pour la première fois dans les données de Corporations Canada, et aucun ne remonte avant octobre 2026, la première lecture.
| Changement | event_type | Pourquoi les ventes s’y intéressent |
|---|---|---|
| Nouvelle société fédérale | new_incorporation | Elle a besoin d’une banque, d’un comptable, d’assurances, de logiciels et de locaux |
| Nouveau nom (souvent une société à numéro qui se donne un nom) | name_change | Une société à numéro qui adopte un nom se prépare à exercer; un changement de marque rouvre contrats, factures et systèmes |
| Siège déménagé | address_change | Nouveaux locaux : aménagement, services, fournisseurs locaux |
| Dissolution en attente (rapports annuels non déposés) | status_change | Compte à risque : revoyez le crédit accordé |
| Dissolution ou intention de dissolution | dissolution | Cessez de vendre à crédit, protégez la facture, nettoyez le CRM |
| Fusion | merger | Deux listes de clients ou de fournisseurs n’en font plus qu’une |
Pour la dissolution en attente, new_value vaut active_strike_off_pending : Corporations Canada a engagé la procédure de dissolution pour non-conformité, et la société peut encore régulariser sa situation. La fiche canadienne ne contient ni capital ni administrateurs : il n’y a donc ni événements de capital ni nominations.
Associez chaque compte à sa fiche avec le numéro de société (ou le NE), abonnez-la et gardez l’identifiant de votre CRM comme label : il revient dans chaque alerte. S’abonner ne coûte aucun crédit.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Vos comptes, tels que le CRM les tient : numéro de société et identifiant interne
comptes = [('426160-7', 'crm-1001'), ('1026366-4', 'crm-1002')]
for numero, crm_id in comptes:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CA', 'company_number': numero})
r.raise_for_status()
trouvees = r.json()['data']
if not trouvees:
continue
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': trouvees[0]['id'],
'country': 'CA',
'label': crm_id, # revient dans chaque alerte
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://exemple.ca/hooks/prometiam',
}).raise_for_status()
Chaque alerte est signée : l’en-tête X-Prometiam-Signature contient sha256= suivi du HMAC-SHA256 du corps, calculé avec le webhook_secret que renvoie POST /monitor. Vérifiez la signature avant de créer la tâche du représentant. Le webhook est offert à tous les forfaits, et les alertes se lisent aussi dans GET /monitor, donc une tâche planifiée la nuit convient aussi. L’essai surveille 3 sociétés, le Starter 25, le Professional 250 et le Scale 2 500.
import hashlib, hmac
def signature_valide(corps: bytes, en_tete: str, webhook_secret: str) -> bool:
attendue = 'sha256=' + hmac.new(webhook_secret.encode(), corps, hashlib.sha256).hexdigest()
return hmac.compare_digest(en_tete, attendue)
# dans votre point d’accès : signature_valide(request.get_data(), request.headers['X-Prometiam-Signature'], SECRET)
Sans company_number ni company_name, GET /company-events/search est le flux d’événements du pays, du plus récent au plus ancien, filtrable par event_type. Il couvre 31 jours au plus (7 par défaut; une date plus ancienne est refusée avec une erreur 400) : une tâche quotidienne qui le lit et garde les sociétés de votre segment trouve les comptes que vous ne surveillez pas encore.
# Tous les changements de nom enregistrés ces 7 derniers jours, du plus récent au plus ancien curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=CA&event_type=name_change&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Chaque appel coûte 2 crédits pour 100 événements au plus et se pagine avec next_cursor, à renvoyer dans cursor. Une société à numéro porte son numéro dans son nom (« 18316287 CANADA LIMITED » pour la société 1831628-7) : pour repérer celles qui se donnent un nom, gardez les name_change dont previous_value commence par des chiffres suivis de « Canada ». Un changement de nom ou d’adresse peut aussi n’être qu’une correction (une faute d’orthographe, un numéro de bureau) : comparez previous_value et new_value avant d’appeler.
La constitution est le premier signal. founded_after liste les sociétés constituées depuis une date, sans nom, de la plus récente à la plus ancienne. Chaque fiche donne la date de constitution (founding_date), la loi constitutive (local_legal_form, le plus souvent CBCA), l’adresse du siège avec la province (region, par exemple QC) et le numéro d’entreprise. La recherche ne filtre pas par province : filtrez sur region, à 1 crédit par page de 100.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CA', 'founded_after': '2026-10-01', 'limit': 100})
r.raise_for_status()
for s in r.json()['data']:
# sièges au Québec; suivez pagination.next_cursor pour la page suivante
if s['region'] == 'QC':
print(s['company_number'], s['company_name'], s['founding_date'], s['city'])
Une société constituée en vertu d’une loi provinciale, comme la Loi sur les sociétés par actions du Québec, n’apparaît pas ici : elle ne relève que du REQ. Voyez REQ ou Corporations Canada : quel registre consulter? et vérifiez une société à la main avec la recherche de société fédérale, gratuite et sans inscription.
vat= est refusée).La surveillance ne coûte aucun crédit. Une recherche de société ou une fiche coûte 1 crédit et une recherche d’événements, 2; une réponse d’erreur ne coûte rien. Le Starter coûte 9,99 € par mois pour 1 000 crédits, le Professional 29,99 € pour 10 000 et le Scale 99,99 € pour 50 000. L’essai gratuit dure 14 jours avec 500 crédits : une carte est requise et rien n’est facturé pendant l’essai, puis le Starter s’applique, sauf annulation. Voir les tarifs.
Contains information licensed under the Open Government Licence – Canada (Corporations Canada, Innovation, Science and Economic Development Canada). Adapted by Prometiam.
Commencer l’essai gratuit de 14 jours · Documentation de l’API
L’essai dure 14 jours et comprend 500 crédits. Une carte de crédit est requise; rien n’est facturé pendant l’essai, puis le forfait Starter (9,99 € par mois) s’applique, sauf annulation.