Read the research report
curl --request GET \
--url https://seneca-research.fly.dev/v1/research/{run_id}/result \
--header 'Authorization: Bearer <token>'import requests
url = "https://seneca-research.fly.dev/v1/research/{run_id}/result"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://seneca-research.fly.dev/v1/research/{run_id}/result', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"report": {
"status": "<string>",
"schema_version": "seneca_research_platform_report",
"errors": [
{
"code": "<string>",
"message": "<string>"
}
],
"question": {
"text": "<string>",
"question_type": "<string>"
},
"answer": {
"headline": "<string>",
"direct_answer": "<string>",
"rationale": "",
"recommended_option": "<string>",
"key_points": [
{
"key_point_id": 123,
"label": "<string>",
"statement": "<string>",
"related_claim_ids": [
123
]
}
],
"recommendation": {
"statement": "<string>",
"related_claim_ids": [
123
]
},
"ranked_options": [
{
"rank": 123,
"option": "<string>",
"rationale": "",
"related_claim_ids": [
123
]
}
],
"primary_disagreement_id": 123,
"notable_minority_insight_id": 123
},
"evidence": {
"claims": [
{
"claim_id": 123,
"statement": "<string>",
"importance": "<string>",
"supporting_model_ids": [
"<string>"
],
"opposing_model_ids": [
"<string>"
],
"mixed_or_uncertain_model_ids": [
"<string>"
],
"caveats": [
"<string>"
],
"supporting_count": 123,
"opposing_count": 123,
"mixed_or_uncertain_count": 123,
"not_addressed_count": 123,
"addressed_count": 123,
"support_share_of_addressed": 123,
"oppose_share_of_addressed": 123,
"mixed_share_of_addressed": 123
}
],
"camps": [
{
"camp_id": 123,
"label": "<string>",
"thesis": "",
"model_ids": [
"<string>"
],
"representative_model_ids": [
"<string>"
],
"model_count": 123,
"eligible_model_count": 123,
"model_share": 123,
"equal_lab_weight_share": 123,
"by_lab": {
"groups": [
{
"key": "<string>",
"count": 123,
"id": "<string>",
"share": 123
}
],
"unknown_count": 0
},
"by_country": {
"groups": [
{
"key": "<string>",
"count": 123,
"id": "<string>",
"share": 123
}
],
"unknown_count": 0
},
"by_model_family": {
"groups": [
{
"key": "<string>",
"count": 123,
"id": "<string>",
"share": 123
}
],
"unknown_count": 0
}
}
],
"unclassified_model_ids": [
"<string>"
]
},
"analysis": {
"disagreements": [
{
"disagreement_id": 123,
"issue": "<string>",
"related_claim_ids": [
123
],
"related_camp_ids": [
123
],
"core_tension": "",
"assumptions": [
"<string>"
],
"why_it_matters": "",
"resolving_information": [
"<string>"
]
}
],
"minority_insights": [
{
"insight_id": 123,
"insight": "<string>",
"supporting_model_ids": [
"<string>"
],
"related_claim_ids": [
123
],
"related_camp_ids": [
123
],
"why_it_matters": ""
}
],
"uncertainties": [
{
"uncertainty_id": 123,
"description": "<string>",
"affected_claim_ids": [
123
],
"why_unresolved": "",
"what_would_resolve_it": [
"<string>"
]
}
]
},
"research_record": {
"research_snapshot": {
"invited": 123,
"successful": 123,
"failed": 123,
"excluded": 123,
"included_in_synthesis": 123,
"unclassified": 123
},
"panel": {
"models": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"lab_origin_country_code": "<string>",
"lab_origin_country_name": "<string>",
"organization_geopolitical_region": "<string>",
"model_family": "<string>"
}
]
},
"provenance": {
"included": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"response_id": "<string>",
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
}
],
"failed": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"response_id": "<string>",
"status": "<string>",
"late_retry": true,
"error": "<string>"
}
],
"excluded": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"response_id": "<string>",
"reason": "<string>"
}
]
},
"generation": {
"run_id": "<string>",
"rerun_id": "<string>",
"generated_at": "<string>",
"run_started_at": "<string>",
"run_completed_at": "<string>"
},
"token_usage": {
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
}
},
"methodology": {
"evidence_collection": "<string>",
"synthesis_and_audit": "<string>",
"stages": [
{
"order": 123,
"label": "<string>",
"key": "<string>"
}
],
"controls": [
{
"id": "<string>",
"label": "<string>",
"description": "<string>"
}
],
"controlled_inference": {
"title": "<string>",
"body": "<string>",
"why_this_matters": "<string>",
"conditions": {
"text_to_text_only": true,
"web_retrieval": true,
"cot_traces": true,
"external_tools": true,
"rag": true,
"reasoning_models": true
},
"instrument_labels": [
"<string>"
]
}
}
},
"object": "research.result"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Research
Read the research report
Return the stored customer report. detail=full, or omitting detail, returns that document. detail=compact removes the question object and places methodology last. Neither read starts research or writes a credit ledger row.
GET
/
v1
/
research
/
{run_id}
/
result
Read the research report
curl --request GET \
--url https://seneca-research.fly.dev/v1/research/{run_id}/result \
--header 'Authorization: Bearer <token>'import requests
url = "https://seneca-research.fly.dev/v1/research/{run_id}/result"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://seneca-research.fly.dev/v1/research/{run_id}/result', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"report": {
"status": "<string>",
"schema_version": "seneca_research_platform_report",
"errors": [
{
"code": "<string>",
"message": "<string>"
}
],
"question": {
"text": "<string>",
"question_type": "<string>"
},
"answer": {
"headline": "<string>",
"direct_answer": "<string>",
"rationale": "",
"recommended_option": "<string>",
"key_points": [
{
"key_point_id": 123,
"label": "<string>",
"statement": "<string>",
"related_claim_ids": [
123
]
}
],
"recommendation": {
"statement": "<string>",
"related_claim_ids": [
123
]
},
"ranked_options": [
{
"rank": 123,
"option": "<string>",
"rationale": "",
"related_claim_ids": [
123
]
}
],
"primary_disagreement_id": 123,
"notable_minority_insight_id": 123
},
"evidence": {
"claims": [
{
"claim_id": 123,
"statement": "<string>",
"importance": "<string>",
"supporting_model_ids": [
"<string>"
],
"opposing_model_ids": [
"<string>"
],
"mixed_or_uncertain_model_ids": [
"<string>"
],
"caveats": [
"<string>"
],
"supporting_count": 123,
"opposing_count": 123,
"mixed_or_uncertain_count": 123,
"not_addressed_count": 123,
"addressed_count": 123,
"support_share_of_addressed": 123,
"oppose_share_of_addressed": 123,
"mixed_share_of_addressed": 123
}
],
"camps": [
{
"camp_id": 123,
"label": "<string>",
"thesis": "",
"model_ids": [
"<string>"
],
"representative_model_ids": [
"<string>"
],
"model_count": 123,
"eligible_model_count": 123,
"model_share": 123,
"equal_lab_weight_share": 123,
"by_lab": {
"groups": [
{
"key": "<string>",
"count": 123,
"id": "<string>",
"share": 123
}
],
"unknown_count": 0
},
"by_country": {
"groups": [
{
"key": "<string>",
"count": 123,
"id": "<string>",
"share": 123
}
],
"unknown_count": 0
},
"by_model_family": {
"groups": [
{
"key": "<string>",
"count": 123,
"id": "<string>",
"share": 123
}
],
"unknown_count": 0
}
}
],
"unclassified_model_ids": [
"<string>"
]
},
"analysis": {
"disagreements": [
{
"disagreement_id": 123,
"issue": "<string>",
"related_claim_ids": [
123
],
"related_camp_ids": [
123
],
"core_tension": "",
"assumptions": [
"<string>"
],
"why_it_matters": "",
"resolving_information": [
"<string>"
]
}
],
"minority_insights": [
{
"insight_id": 123,
"insight": "<string>",
"supporting_model_ids": [
"<string>"
],
"related_claim_ids": [
123
],
"related_camp_ids": [
123
],
"why_it_matters": ""
}
],
"uncertainties": [
{
"uncertainty_id": 123,
"description": "<string>",
"affected_claim_ids": [
123
],
"why_unresolved": "",
"what_would_resolve_it": [
"<string>"
]
}
]
},
"research_record": {
"research_snapshot": {
"invited": 123,
"successful": 123,
"failed": 123,
"excluded": 123,
"included_in_synthesis": 123,
"unclassified": 123
},
"panel": {
"models": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"lab_origin_country_code": "<string>",
"lab_origin_country_name": "<string>",
"organization_geopolitical_region": "<string>",
"model_family": "<string>"
}
]
},
"provenance": {
"included": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"response_id": "<string>",
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
}
],
"failed": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"response_id": "<string>",
"status": "<string>",
"late_retry": true,
"error": "<string>"
}
],
"excluded": [
{
"model_id": "<string>",
"display_name": "<string>",
"lab": {
"slug": "<string>",
"display_name": "<string>"
},
"response_id": "<string>",
"reason": "<string>"
}
]
},
"generation": {
"run_id": "<string>",
"rerun_id": "<string>",
"generated_at": "<string>",
"run_started_at": "<string>",
"run_completed_at": "<string>"
},
"token_usage": {
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
}
},
"methodology": {
"evidence_collection": "<string>",
"synthesis_and_audit": "<string>",
"stages": [
{
"order": 123,
"label": "<string>",
"key": "<string>"
}
],
"controls": [
{
"id": "<string>",
"label": "<string>",
"description": "<string>"
}
],
"controlled_inference": {
"title": "<string>",
"body": "<string>",
"why_this_matters": "<string>",
"conditions": {
"text_to_text_only": true,
"web_retrieval": true,
"cot_traces": true,
"external_tools": true,
"rag": true,
"reasoning_models": true
},
"instrument_labels": [
"<string>"
]
}
}
},
"object": "research.result"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Authorizations
Workspace API key created while signed in on the Developers page. Send Authorization: Bearer seneca_sk_… A Clerk session token is not accepted.
Path Parameters
Query Parameters
full returns the stored report, including the question. compact omits the question and places methodology last. The default is full.
Response
Customer report. report is schema seneca_research_platform_report: answer, evidence, analysis, research record, and methodology.