Poll Account Search Job

Poll search job status

Check the current status of a search job.

Required Headers:

• X-API-Key: Your API key
• X-User-ID: Your email/user ID

Path Parameters:

• job_id: Job ID returned from start-search-job

Response:

• job_id: The job ID
• status: One of “pending”, “running”, “completed”, “failed”
• created_at: Timestamp when job was created
• message: Optional error message (for failed jobs)

Job Status:

• pending: Job created but not yet started
• running: Search is in progress
• completed: Search finished successfully (ready to get results)
• failed: Search failed (check message field for error)

Example Request:

GET /api/v1/account/poll-search-job/550e8400-e29b-41d4-a716-446655440000
Headers:
  X-API-Key: your_api_key
  X-User-ID: [email protected]

Polling Recommendations:

• Poll every 5-10 seconds for small searches (top_k < 50)
• Poll every 10-30 seconds for large searches (top_k > 50)
• Typical search duration: 2-10 minutes depending on query complexity