Get User Jobs
Get job status, counts, and statistics for the authenticated user
Get User Jobs
Retrieve job status information, counts, and statistics for the authenticated user. This simplified endpoint automatically detects the user from the API key, eliminating the need for user IDs in the URL.
Requires a user-specific API key with users:read
permission. Global API
keys should use the legacy routes.
Request
Your user-specific API key with users:read
permission (format:
bna_hexstring
)
Query Parameters
Unix timestamp for filtering jobs from this date
Unix timestamp for filtering jobs until this date
Filter jobs by status (e.g., “completed”, “pending”, “failed”)
Filter jobs by type (e.g., “linkedin_action”, “data_enrichment”)
Examples
Get All Jobs
Get Jobs with Date Range
Get Jobs by Status
Response
The authenticated user’s ID
Always true
for successful requests
Job information and statistics
Advanced Use Cases
1. Job Status Monitoring Dashboard
2. Job Progress Tracking
3. Automated Job Cleanup
Legacy Routes
For backward compatibility, these legacy routes are still supported but require explicit user IDs:
GET /api/v2/users/jobs/userJobStatus/:userId
- Get user job statusGET /api/v2/users/jobs/jobStatus
- Get all jobs (requiresjobs:read
permission)GET /api/v2/users/jobs/jobCounts
- Get job counts onlyPUT /api/v2/users/jobs/editJobMessage/:jobId
- Edit job message (requiresjobs:update
)