List runs
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Configure data
List runs
List the recent runs of a workspace from newest to oldest with status, outcome counts and cursor pagination to follow answer collection after a run starts.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
runs
List runs
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Lists workspace runs from newest to oldest. Use this endpoint to follow answer
collection after a run has been accepted. Read access is available from Growth
and Agency Growth.
Response
Returns200 with success, runs, nextCursor, totalCount and
activeCount. Counts describe the workspace, not only the returned page.
nextCursor: null means there is no further page. Responses are
private, no-store.
Each run includes identity and timestamps, purpose, priority, nullable
scheduledFrequency, questionCount, modelCount, requestedCount,
plannedCount, planningCompletedAt, planningFailed, status,
counts, terminalCount and progressPercentage.
Status is one of QUEUED, PROCESSING, COMPLETED,
COMPLETED_WITH_WARNINGS, FAILED, CANCELLED or NO_WORK.
counts distinguishes success, warning, failed, cancelled,
processing, queued and skipped. Progress is not a guarantee that every
requested answer succeeded; inspect the status and outcome counts.
Synthetic request and response
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/runs?limit=20" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
{
"success": true,
"totalCount": 1,
"activeCount": 0,
"runs": [
{
"id": "55555555-0000-4000-8000-000000000000",
"purpose": "MANUAL",
"priority": "URGENT",
"scheduledFrequency": null,
"questionCount": 12,
"modelCount": 2,
"requestedCount": 24,
"plannedCount": 24,
"planningCompletedAt": "2026-09-01T09:00:01.000Z",
"planningFailed": false,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T09:03:00.000Z",
"status": "COMPLETED",
"counts": {
"success": 24,
"warning": 0,
"failed": 0,
"cancelled": 0,
"processing": 0,
"queued": 0,
"skipped": 0
},
"terminalCount": 24,
"progressPercentage": 100
}
],
"nextCursor": null
}
Errors
Invalid cursors or limits return400 INVALID_PARAMETER; an inaccessible
workspace returns 404 BRAND_NOT_FOUND. See Error codes
and honor Retry-After on 429.
