---
title: "Suivre un envoi groupé"
method: GET
path: "/enrichment/find/batch/{batchId}"
tags: ["Enrichissement"]
---

# Suivre un envoi groupé

`GET /enrichment/find/batch/{batchId}`

## Request

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

Relire toutes les 5 s tant que `status` vaut `pending` ; un résultat par personne dans `items`, dans l'ordre envoyé.

## Path parameters

- `batchId` string, required

## Response `200`

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`: En cours.
- `401`: Clé API absente ou invalide.
- `404`: Ressource introuvable.

---

[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)