Runs
List runs
Returns every run on the account, newest first: QuickBooks actions and the account's other automations.
- No daily limit.
- For assistants, the MCP tool get_event_status.
Request
curl https://api.clickr.cloud/v2/events \
-H "Authorization: Bearer $CLICKR_API_KEY"const response = await fetch(`https://api.clickr.cloud/v2/events`, {
headers: {
Authorization: `Bearer ${process.env.CLICKR_API_KEY}`,
},
});
const data = await response.json();import os
import requests
response = requests.get(
"https://api.clickr.cloud/v2/events",
headers={"Authorization": f"Bearer {os.environ['CLICKR_API_KEY']}"},
)
data = response.json()Response
{
"events": [
{
"_id": "6729c1f04b7e3d0012a91e07",
"type": "createProject",
"status": "successful",
"data": {
"projectId": "4821",
"name": "Henderson Residence Addition",
"status": "In progress",
"startDate": "11/10/2026",
"error": false
},
"createdAt": "2026-11-04T09:12:44.512Z"
}
]
}The whole history comes back in one response; there are no filters or pages. To follow one action, use Get a run with its receipt.
You see the runs of the actions your access on the account includes.
Response
200, as JSON.
eventsarray of objectsThe runs, newest first.
_idstringThe run's id: the receipt its action returned.
typestringWhat the run does: createProject, updateProject, getProject, convertEstimateToInvoice or activateCustomer.
statusstringWhere the run is. Absent until a worker picks the run up, then processing, then successful, invalidInput (QuickBooks refused the input) or failed. queued appears when a run is retried.
One of queued, processing, successful, invalidInput, failed
dataobjectWhat the run did, once it has finished. Its fields depend on the type: see What a run returns.
createdAtstringWhen the run was started, in ISO 8601.
Errors
JSON with an error and, on most, a message saying what to change. All errors
| Status | Error | When |
|---|---|---|
| 401 | No API Key provided | The Authorization header is missing. |
| 401 | No account found for api key provided | The key isn't recognised: mistyped, revoked, or held by someone who has left the account. |
| 401 | No integration found for account | The account has no connector connected yet. |
| 500 | Failed to list events | The runs couldn't be read. Try again. |