v1
latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KBList Jobs
Retrieve a paginated list of jobs with optional filtering and sorting.
get/v2/jobs
Query parameters
projectIdstring uuid required
Example:b8f820ac-2830-4eb8-be86-b7af9c8b92f0
The unique identifier of the project
pageinteger required
Example:1
Current page number
perPageinteger required
Example:10
Number of jobs per page
sortBy'totalCost' | 'usageTime' | 'createdAt' | 'updatedAt'
Example:usageTime
Field to sort by
orderBy'asc' | 'desc'
Example:asc
Sort direction
statusstring
Example:PENDING
Job status to filter by (e.g., PENDING, COMPLETED)
typestring required
Example:TRANSCRIPTION
Job type to filter by (e.g., TRANSCRIPTION, AI_CONTENT)
searchstring
Example:AI_CONTENT
Free text search on job fields
Response
Successful response with job list
Example response
{
"success": true,
"message": "Operation completed successfully",
"messageKey": "OPERATION_SUCCESSFUL",
"data": {
"jobs": [
{
"id": "5b171552-c5f7-42a9-ad92-c7945460dbb5",
"title": "كلام البيزنس اللي كلنا بنستناه في اي Deal | شارك تانك مصر | الموسم الرابع",
"mediaUrl": "https://www.youtube.com/watch?v=dLIKa3TimOM",
"mediaType": "YOUTUBE",
"totalCost": 7,
"status": "COMPLETED",
"createdAt": "2025-12-21T01:27:45.979Z"
}
],
"page": 1,
"totalCount": 50,
"totalPages": 5
}
}