List extraction jobs
List extraction jobs in your account.
Returns a paginated list of extraction jobs with optional filtering by status or document. Jobs are ordered by created_at descending (newest first).
Args: session_and_auth: Database session and auth context (injected). status: Optional filter by job status (pending, processing, completed, failed). document_id: Optional filter by specific document UUID. page: Page number (1-indexed). Values < 1 are normalized to 1. per_page: Items per page (1-100). Values outside range are clamped.
Returns: JobListResponse: Paginated list with total count and job items.
Edge Cases:
- Empty results: Returns empty list with total=0, not 404.
- Invalid page: Page numbers < 1 are normalized to 1.
- Exceeds total: Requesting page beyond total returns empty items list.
- Combined filters: status AND document_id filters are ANDed together.
- Tenant isolation: Only jobs belonging to the authenticated tenant are returned.
Authorizations
API Key authentication. Format: dk_test_ or dk_live_
Query Parameters
Filter by job status
pending, processing, completed, failed Filter by document ID
Page number (1-indexed)
x >= 1Items per page (max 100)
1 <= x <= 100