curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/rows/{contactId}/columns/{columnId}/provenance \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/rows/{contactId}/columns/{columnId}/provenance"
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}/rows/{contactId}/columns/{columnId}/provenance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"provenance": {
"reasoning": "The contact has 22 years of HR experience and currently holds a Recruitment Specialist role, with prior mid-senior titles such as Sr. Human Resources Generalist, which places them mid-level overall.",
"researchSteps": [
"Found the LinkedIn profile for LaShawnda Spencer with a detailed career history.",
"Current job title is Recruitment Specialist with seniority listed as Entry level.",
"Previous roles include mid-senior positions such as Sr. Human Resources Generalist and Recruitment Manager.",
"Overall seniority assessed as mid-level based on career progression and roles held."
],
"sourceUrls": [
"https://linkedin.com/in/lashawnda-spencer-55555b17"
],
"errorMessage": null,
"fetchedAt": "2026-08-25T11:16:53.898Z"
}
}{
"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>"
}
}Where a smart-column cell's value came from
How one smart-column cell got its value: the engine’s reasoning, the researchSteps it took, the sourceUrls it read, an errorMessage when the row failed, and fetchedAt, when the cell was last computed. Provenance is written per cell by each run, so a cell no run has computed yet answers 404 PROVENANCE_NOT_FOUND and a column id that is not a smart column on this list answers 404 COLUMN_NOT_FOUND. The row is addressed by its list row id — a contact id on contact lists, a company id on company lists. Free to call.
Errors:
404LIST_NOT_FOUND— No list with that id belongs to you.404COLUMN_NOT_FOUND— No smart column with that id is on this list (a plain custom column answers this too).404PROVENANCE_NOT_FOUND— The column exists but no run has computed that row, so there is no provenance to show.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.
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/rows/{contactId}/columns/{columnId}/provenance \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/rows/{contactId}/columns/{columnId}/provenance"
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}/rows/{contactId}/columns/{columnId}/provenance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"provenance": {
"reasoning": "The contact has 22 years of HR experience and currently holds a Recruitment Specialist role, with prior mid-senior titles such as Sr. Human Resources Generalist, which places them mid-level overall.",
"researchSteps": [
"Found the LinkedIn profile for LaShawnda Spencer with a detailed career history.",
"Current job title is Recruitment Specialist with seniority listed as Entry level.",
"Previous roles include mid-senior positions such as Sr. Human Resources Generalist and Recruitment Manager.",
"Overall seniority assessed as mid-level based on career progression and roles held."
],
"sourceUrls": [
"https://linkedin.com/in/lashawnda-spencer-55555b17"
],
"errorMessage": null,
"fetchedAt": "2026-08-25T11:16:53.898Z"
}
}{
"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 row whose cell to inspect: the row id from GET /business/lists/{listId}/rows (a contact id on contact lists, a company id on company lists).
Id of the smart column, as returned when it was created or listed by GET /business/lists/{listId}/columns.
Response
Success
Show child attributes
Show child attributes