Skip to main content

Retrieve a Job's Result

Once you have submitted a job asynchronously (e.g., via POST /app/<app_id>/run_async), you can retrieve its created_at, request, result and status by performing a GET request to:

GET /app/<app_id>/job/<job_id>

where:

  • <app_id> is the unique ID of your app.
  • <job_id> is the unique ID of the job you want to retrieve.

Required Headers​

  • x-api-key: A valid API key for the authenticated user.

(If your API also supports x-team-id, be sure to include it if required, but the example below only shows x-api-key.)

Example Requests​

curl --location 'https://api.rungen.ai/app/<APP-ID>/job/<JOB-ID>' \
--header 'x-api-key: <YOUR-API-KEY>'

A successfull response returns 200 OK with the creation time, the request of the job, the result of the job and the status. An example of a job still to be processed is:

{
    "data": {
        "id": "e9257302-3c4d-47d0-bf90-5be1e4e3b6e2",
        "created_at": "2025-01-22 15:22:28",
        "request": { "prompt": "Hello World" },
        "result": null,
        "status": "IN_QUEUE"
    }
}

where a job that has been processed will return:

{
    "data": {
        "id": "e9257302-3c4d-47d0-bf90-5be1e4e3b6e2",
        "created_at": "2025-01-22 15:22:28",
        "execution_time": "100.0",
        "request": {
          "width": 1024, 
          "height": 1024, 
          "prompt": "Hello World", 
          "guidance_scale": 5, 
          "num_inference_steps": 60
        },
        "result": {
            "images": [
                {
                    "image": "https://rungenai-output-v1.s3.us-east-2.amazonaws.com/01-25/123454335-b905-2df-e-18b12f80c6ff-u1/058cad14.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVA5YKZZRZFJTT7FH%2F20250104%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20250104T150225Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=fc16844ed2cbd44f9392f2658199f3c927b499653ad93d6aa06770a33f40c302"
                }
            ]
        },
        "status": "COMPLETED"
    }
}

With this endpoint, you can monitor job progress and retrieve final results after your asynchronous jobs complete. If the status is not yet COMPLETED, you may need to poll periodically or check back later for updated status.