Créer une société depuis votre logiciel ou votre agent

Le catalogue GlobalStart, les prix publics, le devis ferme, l'ouverture et le suivi d'un dossier : tout est exposé en JSON, en REST et en MCP. Un agent peut interroger les prix, produire un devis, déposer un dossier pour un client identifié et suivre son état — sans navigateur.

Premier appel en 30 secondes Demander une clé API

Lecture et devis : sans clé. Ouverture de dossier : clé API. Aucun paiement n'est prélevé par l'API — le prix ferme est confirmé par écrit avant tout engagement.

Ce que l'API expose

Lecture libre

Catalogue & prix

29 juridictions : forme de société, devise, prix public, délai annoncé, prestations incluses, page et lien de commande. Filtres par région, devise et recherche libre.

Lecture libre

Devis ferme

Un devis daté, valable 7 jours : prix, devise, TVA, délai, inclus, conditions. Référence DEV-… pour la traçabilité côté agent.

Clé API

Dossier & suivi

Ouverture d'un dossier pour un client identifié, référence GS-AAAA-XXXXXX, pipeline en 7 étapes, idempotence pour les réessais d'agent.

Démarrage

Un appel, pas d'installation

Base : https://globalstart.fr/api/v1 — JSON en entrée et en sortie, CORS ouvert, aucune authentification pour la lecture.

# 1. Le catalogue, filtrable (region, devise, q)
curl -s "https://globalstart.fr/api/v1/juridictions?devise=EUR"

# 2. Une juridiction précise
curl -s https://globalstart.fr/api/v1/juridictions/royaume-uni

# 3. Un devis ferme
curl -s -X POST https://globalstart.fr/api/v1/devis \
  -H "Content-Type: application/json" \
  -d '{"juridiction":"france","formule":"essentiel","pays_residence":"FR"}'

# 4. Ouvrir un dossier (clé API)
curl -s -X POST https://globalstart.fr/api/v1/dossiers \
  -H "X-API-Key: gs_live_…" -H "Idempotency-Key: dossier-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"juridiction":"royaume-uni","nom":"Camille Martin",
       "email":"camille@exemple.fr","telephone":"+33612345678",
       "pays_residence":"France","denomination_sociale":"Northwind Ltd",
       "agent":{"nom":"mon-agent","type":"ia"}}'

# 5. Suivre le dossier
curl -s "https://globalstart.fr/api/v1/dossiers/GS-2026-XXXXXX?email=camille@exemple.fr"

Référence

Endpoints

Méthode	Chemin	Ce qu'il fait	Accès
GET	`/api/v1`	Index : endpoints, découverte, avertissement	libre
GET	`/api/v1/sante`	État du service, fraîcheur du catalogue	libre
GET	`/api/v1/juridictions`	Liste et prix publics — filtres `region`, `devise`, `q`	libre
GET	`/api/v1/juridictions/{slug}`	Détail : forme, formules, délai, inclus, page	libre
POST	`/api/v1/devis`	Devis ferme (7 jours) : prix, TVA, délai, inclus	libre
POST	`/api/v1/dossiers`	Ouvre un dossier client, renvoie une référence suivie	clé API
GET	`/api/v1/dossiers/{reference}`	Statut, étape courante, avancement, prochaine étape	e-mail du dossier ou clé

Erreurs : enveloppe stable {"ok":false,"error":"code","message":"…"} avec le code HTTP correspondant (400, 401, 404, 409, 422, 429, 503). Spécification complète : OpenAPI 3.1.

Authentification & limites

Une clé, des quotas, des réessais sûrs

La clé se présente en en-tête X-API-Key: gs_live_… ou Authorization: Bearer gs_live_…. Elle est délivrée sur demande à contact@globalstart.fr, avec le nom de l'organisation qui l'utilise.

Quotas par heure et par IP : 600 lectures de catalogue, 60 devis, 20 ouvertures de dossier, 120 suivis.
Idempotence : envoyez Idempotency-Key sur POST /dossiers ; un réessai renvoie le dossier déjà créé, avec "idempotent": true.
Données personnelles : l'e-mail sert d'identifiant de suivi ; un dossier ne se lit qu'avec cet e-mail ou une clé autorisée.

Agents IA · MCP

Brancher un agent en une ligne

Le même service est un serveur MCP (Model Context Protocol, JSON-RPC 2.0, transport Streamable HTTP) : https://globalstart.fr/api/mcp.php. Cinq outils, décrits avec leur schéma : globalstart_lister_juridictions, globalstart_detail_juridiction, globalstart_devis, globalstart_creer_dossier, globalstart_suivi_dossier.

// Configuration client MCP (Claude Desktop, Cursor, Hermes, etc.)
{
  "mcpServers": {
    "globalstart": {
      "type": "streamable-http",
      "url": "https://globalstart.fr/api/mcp.php",
      "headers": { "X-API-Key": "gs_live_…" }
    }
  }
}

Sans clé, les outils de lecture et de devis fonctionnent ; globalstart_creer_dossier répond par une erreur explicite qui indique comment obtenir la clé. Les outils d'écriture sont marqués non destructifs et non idempotents : l'agent doit envoyer une Idempotency-Key s'il réessaie.

Découverte automatique

Ce que les agents trouvent tout seuls

Carte d'agent A2A — compétences, transport, documentation.
Carte du serveur MCP — endpoint et liste des outils.
mcp.json — configuration prête à copier.
OpenAPI 3.1 — schémas, codes de retour, exemples.
llms.txt — présentation du site pour les modèles.

Périmètre

Ce que l'API ne fait pas

Elle ne prend aucun paiement : un dossier ouvert est une demande, le prix ferme est confirmé par écrit avant engagement.
Elle ne donne aucun conseil fiscal et ne promet aucun avantage fiscal : GlobalStart n'est ni avocat, ni notaire, ni expert-comptable, ni fiscaliste.
Elle n'annonce pas une immatriculation : le registre du pays visé décide, et la décision d'ouverture d'un compte appartient à la banque.
Elle ne publie que des prix et des faits sourcés : pas de frais officiels inventés, pas de délai garanti.

Notre méthode · Nos services · Nous écrire