---
title: "Envoi groupé (jusqu'à 100 personnes)"
method: POST
path: "/enrichment/find/batch"
tags: ["Enrichissement"]
---

# Envoi groupé (jusqu'à 100 personnes)

`POST /enrichment/find/batch`

## Request

- Base URL: `https://api.basile.cc`
- URL: `https://api.basile.cc/enrichment/find/batch`
- Auth: API key in header `Authorization`

Chaque personne est traitée comme un `POST /enrichment/find` (mêmes champs, prix et règles),
sous un `batch_id`. Avec un `request_id`, rejouer le lot rend le même lot et lance les
personnes non parties (`not_started`), sans refacturer les autres.

## Request body

- EnrichmentBatchRequest
  - `people` object[], required
    - `full_name` string: Nom complet (ou first_name + last_name, 60 caractères chacun). Obligatoire.
    - `first_name` string
    - `last_name` string
    - `domain` string: Domaine de la société (une URL ou une adresse e-mail sont réduites au domaine).
    - `company_name` string
    - `linkedin_url` string: Profil LinkedIn personnel (https://www.linkedin.com/in/…). Obligatoire pour le numéro.
    - `find` union: Ce qu'il faut trouver (défaut : email).
      - 'email' | 'phone' | 'both'
      - string[]
    - `request_id` string: Identifiant d'idempotence (recommandé).
    - `person_id` string: L'_id d'une personne de /people/find : ce qui est possédé est resservi, ce qui est trouvé est rangé sur la fiche.
    - `country_code` string: Pays de la société, code ISO à deux lettres.
    - `wait` boolean: Attendre le verdict côté serveur (~25 s au plus).
    - `ref` string: Votre identifiant, rendu avec le résultat.
  - `find` 'email' | 'phone' | 'both': Pour tout le lot (ou par personne).
  - `request_id` string

## Response `200`

Déjà terminé.

- EnrichmentBatchResponse
  - `success` boolean
  - `batch_id` string
  - `status` 'pending' | 'completed'
  - `count` integer
  - `not_started` integer: Personnes non lancées (plafond de sécurité) : rejouer avec le même request_id.
  - `counts` object: Canaux par statut.
  - `charged_cents` integer
  - `balance_cents` integer
  - `held_cents` integer
  - `currency` string
  - `replayed` boolean
  - `retry_after_seconds` integer
  - `items` object[]
    - `success` boolean
    - `id` string
    - `status` 'pending' | 'completed'
    - `email` EnrichmentChannel
      - `status` 'pending' | 'found' | 'not_found' | 'failed' | 'skipped' | 'insufficient_balance'
      - `stage` 'queued' | 'searching': Pour pending : en file, ou recherche en cours.
      - `value` string: La coordonnée, si found.
      - `verified` boolean: E-mail vérifié.
      - `already_owned` boolean: Déjà possédée par le compte : 0 centime.
      - `reason` string: Pour skipped ou failed (ex. linkedin_url_required).
      - `charged_cents` integer
    - `phone` EnrichmentChannel
      - `status` 'pending' | 'found' | 'not_found' | 'failed' | 'skipped' | 'insufficient_balance'
      - `stage` 'queued' | 'searching': Pour pending : en file, ou recherche en cours.
      - `value` string: La coordonnée, si found.
      - `verified` boolean: E-mail vérifié.
      - `already_owned` boolean: Déjà possédée par le compte : 0 centime.
      - `reason` string: Pour skipped ou failed (ex. linkedin_url_required).
      - `charged_cents` integer
    - `charged_cents` integer: Total débité pour cette demande.
    - `balance_cents` integer: Solde restant.
    - `held_cents` integer: Réservé pour les recherches en cours.
    - `currency` string
    - `replayed` boolean: Demande rejouée par son request_id.
    - `retry_after_seconds` integer: Délai conseillé avant de relire (si pending).
    - `index` integer
    - `ref` string

## Other responses

- `202`: Accepté : relire GET /enrichment/find/batch/{batchId}.
- `400`: people_required, batch_too_large, ou personne invalide (avec index).
- `401`: Clé API absente ou invalide.
- `402`: Solde d'enrichissement insuffisant : rien n'est lancé.
- `409`: request_id_conflict.
- `429`: Plafond de sécurité (50 000 recherches en file par compte, ou 50 requêtes/s). Attendre Retry-After.

---

[API](https://skmtc.dev/basile/apis/basile-api.md) · [All operations](https://skmtc.dev/basile/apis/basile-api/llms.txt) · [OpenAPI document](https://skmtc.dev/basile/apis/basile-api/revisions/f260fbfcc5eb?raw)