Aller au contenu

Pappers

Contrôleur HTTP qui expose une recherche d'entreprises françaises via l'API Pappers. Source : pappers.controller.ts.

Utilisé côté investisseur, principalement pour rechercher et sélectionner sa société pendant les flux d'onboarding personne morale ou de création de SPV.

Tous les endpoints requièrent un JWT investisseur valide (JwtAuthGuard) et le rôle CUSTOMER (UserRoleGuard).

GET /pappers/search

Recherche d'entreprise par nom ou par SIREN, servie par deux endpoints Pappers selon la saisie. L'aiguillage vit dans le provider : pappers.api.ts.

Saisie q Endpoint Pappers appelé Résultat
9 chiffres (espaces tolérés) /entreprise la fiche, mappée en une suggestion unique
autre chose /suggestions resultats_nom_entreprise tel quel

Un SIREN inconnu de Pappers renvoie 200 avec une liste vide, pas une erreur — c'est un résultat de recherche, pas une panne.

Query params

Validés via pappersSearchEndpoint.request.query (depuis @bricks-common/api-communication).

Paramètre Type Requis Description
q string non vide oui Termes de recherche (nom d'entreprise ou SIREN)
longueur number non Nombre max de résultats (défaut Pappers : 10)
types string[] non Filtre par type d'entité (joints en CSV avant transmission à Pappers)

Response

{
  "resultats_nom_entreprise": [
    {
      "siren": "552120222",
      "nom_entreprise": "EDF",
      "date_creation": "1946-04-08",
      "domaine_activite": "Production d'électricité",
      "forme_juridique": "SA, société anonyme",
      "capital": 1000000,
      "siege": {
        "code_pays": "FR",
        "code_postal": "75008",
        "ville": "Paris"
      }
    }
  ],
  "resultats_siren": []
}

forme_juridique et capital sont renvoyés par Pappers /suggestions. greffe (ville du RCS) est optionnel sur ce contrat — il arrive surtout via /entreprise.

Les deux tableaux sont optionnels — la réponse Pappers ne renvoie que celui qui correspond au type de requête.

Erreurs

Code Statut Cause
BadRequestException('Pappers search failed') 400 Erreur HTTP côté Pappers ou échec de validation de la réponse Pappers

Le détail de l'erreur (réseau, validation idonttrustlikethat, etc.) est loggé côté serveur via le logger PappersApi mais n'est pas remonté au client.

Liens