Get job details
Retrieve details for a specific extraction job.
Returns comprehensive information about an extraction job including status, timestamps, processing time, and error messages if applicable.
Args: job_id: UUID of the extraction job to retrieve. session_and_auth: Database session and auth context (injected).
Returns: JobDetailResponse: Full job details including all timestamps and error info.
Raises: HTTPException 404: Job not found or not accessible by tenant.
Edge Cases:
- Tenant isolation: RLS ensures 404 (not 403) for other tenants’ jobs.
- Null timestamps: processing_started_at and processing_completed_at are null for pending jobs; processing_completed_at is null for processing jobs.
- Error messages: error_message is only populated for failed jobs.
- Processing time: processing_time_seconds is null until job completes.
Authorizations
API Key authentication. Format: dk_test_ or dk_live_
Path Parameters
UUID of the extraction job
Response
Detailed information about the extraction job
Response for job detail (GET /v1/jobs/{id}).
Note: Webhooks are configured separately via POST /v1/webhooks.
Unique identifier for the extraction job
Document this job belongs to
Current job status
pending, processing, completed, failed Job creation timestamp (ISO 8601)
Classified document type
Why this document type was chosen
When extraction processing began (ISO 8601)
When extraction completed (ISO 8601)
Total processing duration in seconds
Error details if status is 'failed'