Skip to main content
GET
/
jobs
/
:id
Get Job
curl --request GET \
  --url https://api.techforgeinnovate.com/jobs/:id \
  --header 'x-api-key: <api-key>'
{
  "uuid": "<string>",
  "job_status": "<string>",
  "input": {},
  "output": {}
}

​
Get Job

Returns the raw job record for a job that belongs to the authenticated account.

​
Path parameters

​
id
string
required
Job UUID.

​
Example request

curl "https://api.techforgeinnovate.com/jobs/15a6331b-3837-4ae8-8fa7-d3ead3388d77" \
  -H "x-api-key: $TFI_API_KEY"

​
Successful response

The controller returns the persisted Prisma job row directly.
​
uuid
string
required
Job UUID.
​
job_status
string
Job status such as QUEUED, STARTED, IN_PROGRESS, FAILED, or SUCCESS.
​
input
object
Original job payload submitted to POST /jobs/v2.
​
output
object
Worker-produced output payload, if present.
Example response: 
{
  "uuid": "15a6331b-3837-4ae8-8fa7-d3ead3388d77",
  "user_id": "c95a2ab1-7c10-4a03-9d25-55f905d2b6f0",
  "template_id": "468ea7a0-66e1-4357-a760-236e54167f3e",
  "input": {
    "template_id": "468ea7a0-66e1-4357-a760-236e54167f3e",
    "job_type": "ai_talking_video",
    "version": 2,
    "values": {
      "headline": "Launch in minutes"
    }
  },
  "output": {
    "output": "ai-talking-videos/468ea7a0-66e1-4357-a760-236e54167f3e/outputs/15a6331b-3837-4ae8-8fa7-d3ead3388d77.mp4"
  },
  "values": {
    "headline": "Launch in minutes"
  },
  "job_status": "SUCCESS",
  "job_type": "ai_talking_video",
  "credit_used": "12.5",
  "created_at": "2026-04-16T12:03:02.000Z",
  "updated_at": "2026-04-16T12:05:18.000Z"
}

​
Not found response

If the job does not exist or does not belong to the API-key owner, the controller returns: 
{
  "message": "Job not found"
}

​
Status codes

  • 200 OK for both found and not-found payloads under the current implementation
  • 401 Unauthorized when the key is missing or invalid