curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/research/runs/{runId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/research/runs/{runId}"
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/research/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"run": {
"runId": "68a205cc9c41d20014b40888",
"prompt": "Series A fintech companies in Europe hiring a Head of Sales",
"status": "completed",
"turnCount": 14,
"createdAt": "2026-08-25T10:00:00.000Z",
"updatedAt": "2026-08-25T10:11:48.000Z",
"effort": "medium",
"spend": {
"reservedCredits": 0,
"settledCredits": 890,
"capCredits": 2000
},
"resultListId": "68a205cc9c41d20014b40999",
"reportMarkdown": "# European fintech Series A\n\n12 companies matched. Highlights:\n\n- **Northwind Pay** raised a $14M Series A in June and posted a Head of Sales role in Berlin.\n",
"errorCode": null,
"cancelRequestedAt": 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>"
}
}A research run's state, report, and result list
A research run’s full state. Poll it until status is completed, failed or cancelled (in-flight statuses: queued, planning, plan_review, running, generating_csv, uploading). prompt is the text the run was started with; spend shows the credits reserved, settled and the cap effort set; reportMarkdown is the markdown report (null until the run writes it); resultListId is the list holding the people or companies the research surfaced (null when none was created), readable with GET /business/lists/; errorCode explains a failed run and cancelRequestedAt is set once a cancel has been accepted. Rate limit: 30 requests per minute, 1000 per day.
Errors:
404RESEARCH_RUN_NOT_FOUND— No research run with that id belongs to the token owner.422VALIDATION_FAILED—runIdis not a 24-character hex id.429RATE_LIMITED— Per-user quota for this endpoint family exceeded (30 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds.
Requires one of the following token scopes: research.
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/research/runs/{runId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/research/runs/{runId}"
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/research/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"run": {
"runId": "68a205cc9c41d20014b40888",
"prompt": "Series A fintech companies in Europe hiring a Head of Sales",
"status": "completed",
"turnCount": 14,
"createdAt": "2026-08-25T10:00:00.000Z",
"updatedAt": "2026-08-25T10:11:48.000Z",
"effort": "medium",
"spend": {
"reservedCredits": 0,
"settledCredits": 890,
"capCredits": 2000
},
"resultListId": "68a205cc9c41d20014b40999",
"reportMarkdown": "# European fintech Series A\n\n12 companies matched. Highlights:\n\n- **Northwind Pay** raised a $14M Series A in June and posted a Head of Sales role in Berlin.\n",
"errorCode": null,
"cancelRequestedAt": 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
The research run id (24-character hex), as returned in run.runId by POST /business/research/runs.
Response
Success
Show child attributes
Show child attributes