Skip to main content
GET
/
v1
/
runs
List Runs
curl --request GET \
  --url https://app.uselamina.ai/v1/runs \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "runId": "fc32ae7d-6840-4be3-8fb1-539a60e33fc3",
      "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
      "status": "completed",
      "source": "api_app",
      "errorMessage": null,
      "startedAt": "2026-04-15T10:30:01.000Z",
      "completedAt": "2026-04-15T10:32:15.000Z",
      "createdAt": "2026-04-15T10:30:00.000Z"
    },
    {
      "runId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "workflowId": "483754bf-24c9-48c1-a70e-71d2ff9682fa",
      "status": "failed",
      "source": "api_app",
      "errorMessage": "Image generation timed out",
      "startedAt": "2026-04-15T09:15:01.000Z",
      "completedAt": "2026-04-15T09:20:01.000Z",
      "createdAt": "2026-04-15T09:15:00.000Z"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 25,
    "offset": 0
  }
}
List past executions for your workspace, ordered by creation time (newest first). Use this to build execution history views, audit logs, or find a specific run you need to inspect. Supports filtering by status, app ID, and time range. Results are paginated with offset/limit. Default limit is 25, maximum 100.

Authorizations

​
x-api-key
string
header
required

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

Query Parameters

​
status
enum<string>

Filter runs by status. Omit to return all statuses.

Available options:
queued,
running,
completed,
failed,
cancelled
​
appId
string<uuid>

Filter by app/workflow ID. Only returns runs of this specific app.

​
limit
integer
default:25

Maximum number of runs to return per page.

Required range: x <= 100
​
offset
integer
default:0

Number of runs to skip (for pagination).

​
since
string<date-time>

Only return runs created after this ISO 8601 timestamp.

Response

Paginated list of run summaries

​
data
object[]
​
pagination
object

Pagination metadata for list endpoints