Skip to main content

​
GET /public/v1/bulk/jobs

This endpoint returns a paginated list of all bulk enrichment jobs submitted with your API key. You can use query parameters to paginate through results.

​
Authorization

Header:
X-API-Key: <your_api_key> API key must be generated from your account at dashboard.powerlead.com.

​
🔎 Query Parameters

  • skip (integer, optional)
    Number of records to skip (for pagination). Minimum: 0 Default: 0
  • limit (integer, optional)
    Maximum number of records to return per request. Minimum: 1 Maximum: 100 Default: 10

​
Success Response

HTTP 200 OK 
{
  "jobs": [
    {
      "task_id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "completed",
      "records": 500,
      "created_at": "2025-07-01T10:00:00Z",
      "completed_at": "2025-07-01T10:03:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5,
    "total_jobs": 50
  }
}
Field Descriptions:
  • task_id: Unique job identifier.
  • status: Current job status (queued, processing, completed, or failed).
  • records: Number of records submitted in the job.
  • created_at: When the job was submitted.
  • completed_at: When the job finished (or null if not completed).

​
Error Responses

HTTP 422 Unprocessable Entity – Invalid pagination parameters. 
{
  "detail": [
    {
      "loc": ["query", "limit"],
      "msg": "value is not in valid range",
      "type": "value_error"
    }
  ]
}

​
Notes

  • Use skip and limit to paginate through large job histories.
  • Jobs are listed in reverse chronological order (most recent first).