Job lifecycle

Use the status endpoint while processing. Use the job endpoint for registration metadata and related links.

Check workflow status

export LINGOPAL_API_KEY="your-api-key"
export JOB_ID="replace-with-job-id"

curl "https://api.lingopal.ai/v2/jobs/$JOB_ID/status" \
  -H "X-API-Key: $LINGOPAL_API_KEY"

curl -X GET "https://example.com/v2/jobs/job_123/status"

{  "job_id": "job_123",  "job_type": "video",  "status": "processing",  "stage": "translating",  "sub_stage": "dubbing",  "workflows": {    "translation": {      "status": "processing",      "languages": [        {          "target_language": "es",          "status": "processing"        },        {          "target_language": "fr",          "status": "queued"        }      ]    }  },  "outputs": {    "transcript": true,    "subtitles": false  },  "updated_at": "2026-07-07T16:10:00Z"}

Use the API Reference entry for getJobStatus for full status fields and response schema.

Top-level status is one of queued, processing, completed, or failed. The response can also include:

• workflows.translation and workflows.subtitles
• outputs availability flags
• stage and sub_stage
• error when processing fails
• updated_at

Poll every few seconds, increase the interval for long media, and stop at completed or failed.

Inspect registration metadata

export LINGOPAL_API_KEY="your-api-key"
export JOB_ID="replace-with-job-id"

curl "https://api.lingopal.ai/v2/jobs/$JOB_ID" \
  -H "X-API-Key: $LINGOPAL_API_KEY"

curl -X GET "https://example.com/v2/jobs/job_123"

{  "job_id": "job_123",  "name": "Product Demo",  "job_type": "video",  "source_url": "https://cdn.example.com/uploads/product-demo.mp4",  "created_at": "2026-07-07T16:00:00Z",  "updated_at": "2026-07-07T16:05:00Z",  "links": {    "self": "/v2/jobs/job_123",    "status": "/v2/jobs/job_123/status",    "translations": "/v2/jobs/job_123/translations",    "subtitles": "/v2/jobs/job_123/subtitles"  }}

Use the API Reference entry for getJob for complete response metadata.

This returns the job name, type, source URL, timestamps, and related links. It is not the primary workflow-progress response.

Rerun safely

Wait for the active workflow to finish before starting another run. For translation, reset defaults to true and prunes stale target-language state before refreshing progress. For subtitles, reset defaults to false. Set either value explicitly when rerun behavior matters.