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 des entreprises par nom ou SIREN auprès de l'API Pappers (endpoint /suggestions). L'API retourne deux listes : suggestions par nom et suggestions par SIREN.

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é",
      "siege": {
        "code_pays": "FR",
        "code_postal": "75008",
        "ville": "Paris"
      }
    }
  ],
  "resultats_siren": []
}

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