Endpoint
GET https://api.intellibase.dev/api/v1/projects/{project_id}/jobs/{job_id}
Path Parameters
The unique identifier of the project
The unique identifier of the job
Authentication
Requires a valid API key with access to the project.
Response
Unique identifier for the job
The project this job belongs to
The document identifier from the ingestion request
Job status: pending, running, completed, or failed
Number of text chunks processed
Number of entities created (0 for Vector-Only projects)
Number of relationships created (0 for Vector-Only projects)
When the job started processing
When the job finished (null if still running or pending)
Error details if status is failed
curl https://api.intellibase.dev/api/v1/projects/proj-abc123/jobs/job-abc123 \
-H "Authorization: Bearer ib-your-api-key"
{
"job_id": "job-abc123",
"project_id": "proj-abc123",
"source_doc_id": "doc-001",
"status": "completed",
"chunks_processed": 12,
"nodes_created": 8,
"edges_created": 15,
"started_at": "2024-01-15T10:30:00Z",
"completed_at": "2024-01-15T10:30:15Z",
"error_message": null
}
Poll this endpoint to monitor ingestion progress after submitting via Ingest Text. Recommended polling interval: 2-5 seconds for async jobs.For synchronous ingestion, the job is complete when the ingest endpoint returns.
Job Statuses
| Status | Description | Next Action |
|---|
pending | Job queued, waiting to start | Keep polling |
running | Job is being processed | Keep polling |
completed | Job finished successfully | Data is ready to query |
failed | Job failed with an error | Check error_message, fix issue, retry |
Common Errors
| Error Message | Cause | Solution |
|---|
LLM API timeout after 3 retries | LLM service unavailable | Retry ingestion |
Invalid extraction: missing required properties | Malformed LLM response | Retry, or report if persists |
Database connection lost | Temporary connection issue | Retry ingestion |
Token usage limit exceeded | Account token limit reached | Upgrade plan or wait for reset |