Poll a smart-column run
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/smart-columns/{jobId}/status \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/smart-columns/{jobId}/status"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}/smart-columns/{jobId}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"job": {
"id": "68a1f6109c41d20014b3ec21",
"status": "processing",
"mode": "initial",
"runOn": "first_100",
"totalRows": 100,
"processedRows": 40,
"successfulRows": 38,
"failedRows": 2,
"creditsUsed": 800,
"creditsPerRow": 20,
"createdAt": "2026-08-20T09:15:00.000Z",
"startedAt": "2026-08-20T09:15:02.000Z",
"completedAt": null,
"cancelledAt": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Smart columns
Poll a smart-column run
Progress of one smart-column run: the jobId returned by create, rerun, or a prompt edit. status moves from pending to processing and ends as completed, partially_completed (some rows failed), failed or cancelled (superseded by a newer run or a prompt edit). processedRows, successfulRows and failedRows count against totalRows, and creditsUsed is what the run has consumed so far at creditsPerRow. mode says why the run exists: initial for the column’s first run, all or new_only for a rerun, refresh for the re-run a prompt edit starts, single_row for an automation. Poll every few seconds until the status is terminal; the values are then on GET /business/lists/{listId}/rows under columnValues[columnId]. Free to call.
Errors:
404LIST_NOT_FOUND— No list with that id belongs to you.404JOB_NOT_FOUND— No run with that jobId exists on this list.422VALIDATION_FAILED— The path, query or body failed validation;paramnames the offending field andmessagesays why.429RATE_LIMITED— More than 120 requests per minute or 10,000 per day on the lists bucket, which every /business/lists endpoint shares; retry after Retry-After.500UNEXPECTED_ERROR— The request could not be completed; quote request_id to support.
Requires one of the following token scopes: lists.
GET
/
business
/
lists
/
{listId}
/
smart-columns
/
{jobId}
/
status
Poll a smart-column run
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/smart-columns/{jobId}/status \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/smart-columns/{jobId}/status"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}/smart-columns/{jobId}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"job": {
"id": "68a1f6109c41d20014b3ec21",
"status": "processing",
"mode": "initial",
"runOn": "first_100",
"totalRows": 100,
"processedRows": 40,
"successfulRows": 38,
"failedRows": 2,
"creditsUsed": 800,
"creditsPerRow": 20,
"createdAt": "2026-08-20T09:15:00.000Z",
"startedAt": "2026-08-20T09:15:02.000Z",
"completedAt": null,
"cancelledAt": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Path Parameters
Id of the list that owns the smart column.
Id of the smart-column run to poll, as returned in jobId by the create or rerun call that started it.
Response
Success
Show child attributes
Show child attributes