Project HermesHermes Docs

Process Status

Check the status of a lead discovery process

Process Status

Get detailed status of a specific lead discovery process.

  • id (integer) (required) — The process ID
curl -H "Authorization: Bearer hermes_your_api_key" \
  https://api.hermes.camie.ai/v1/leads/process/3

Response

{
  "success": true,
  "message": "Process fetched",
  "data": {
    "id": 3,
    "userId": "3dd2d062-...",
    "leadListId": 1,
    "leadCount": 100,
    "processedLeads": 76,
    "foundLeads": 68,
    "searchTerm": "Solar installation",
    "adReachedCountries": ["GB"],
    "status": "completed",
    "statusMessage": "Completed: found 68 leads from 76 processed ads",
    "createdAt": "2026-03-14T10:53:21.877Z",
    "updatedAt": "2026-03-14T12:20:35.523Z"
  }
}

💡 Tip: Poll this endpoint every 10–30 seconds to track a running discovery process. The processedLeads and foundLeads fields update in real-time.

On this page