Skip to main content
GET
/
v1
/
runs
/
{runId}
Get Run Status
curl --request GET \
  --url https://app.uselamina.ai/v1/runs/{runId} \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "runId": "fc32ae7d-6840-4be3-8fb1-539a60e33fc3",
    "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
    "status": "queued",
    "outputs": [
      {
        "id": "aiDesignerNode-1773051929782-5yzqjkwpm",
        "label": "AI Designer",
        "type": "pending",
        "value": null,
        "status": "pending",
        "error": null
      }
    ],
    "errorMessage": null,
    "startedAt": null,
    "completedAt": null,
    "createdAt": "2026-03-23T12:22:40.552Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.uselamina.ai/llms.txt

Use this file to discover all available pages before exploring further.

Check the current status and outputs of an execution. For agents, prefer GET /v1/runs/{id}/wait — it blocks until the execution finishes, so you don’t need a polling loop. Use this endpoint when you need to check status without blocking, or as a fallback. Status progresses: queued → running → completed or failed. Outputs start as pending placeholders and resolve to image, video, or text with a URL or content value.

Authorizations

​
x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Path Parameters

​
runId
string<uuid>
required

The run ID returned from the Run App or Content Create endpoint

Response

Run status with output values

​
data
object

Poll until status is completed or failed.