Seeds / Job Status
Get Job Status
Check the processing status of a seed upload job. Returns detailed progress information including current stage, percentage complete, and any error messages. Poll this endpoint after uploading a seed to track when it becomes searchable.
GET
{baseAPIUrl}/seeds/job/:jobIdAuthentication
Required. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYPath Parameters
| Parameter | Type | Description |
|---|---|---|
| jobId | string | UUID of the job to check |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | string | Required | Application identifier |
| externalUserId | string | Required | External user identifier |
Response
| Field | Type | Description |
|---|---|---|
| jobId | string | Unique job identifier |
| state | string | pending, processing, completed, failed |
| progress | number | Progress percentage (0-100) |
| seedId | string | Associated seed ID (when completed) |
| result | object | Job result details (when completed) |
| error | string | Error message (when failed) |
| createdAt | string | ISO 8601 timestamp of job creation |
| completedAt | string | ISO 8601 timestamp of completion |
Job States
| State | Description |
|---|---|
| pending | Job queued, waiting to start |
| processing | Job currently being processed |
| completed | Job finished successfully |
| failed | Job failed with error |
Polling Best Practices
- Poll every 1-2 seconds during processing
- Use exponential backoff after repeated checks
- Set a reasonable timeout (e.g., 5 minutes)
- Handle failed state and errors gracefully
Try It
Path Parameters
UUID of the job to check
Query Parameters
Application identifier
External user identifier