Get a summary
Fetch a summary created by POST /v1/ask/summary. Poll until finished is
true.
This is the dedicated summary poll endpoint. GET /v1/ask/questions/{question_id}/answer
returns the same payload, so either works — use this one when a summary is what
you asked for.
Wait 2-4 seconds before your first poll. A brand-new summary is not
queryable immediately, and an early poll returns 404.
End-to-end
BASE=https://api.askmiso.com
QID=$(curl -s -X POST "$BASE/v1/ask/summary" \
-H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
-d '{ "instructions": "Summarize this week in 3 bullets.",
"fq": "published_at:[NOW-7DAYS TO NOW]" }' \
| jq -r .data.question_id)
sleep 3
curl "$BASE/v1/ask/summaries/$QID/summary" -H "X-Api-Key: $KEY"
While it works:
{
"message": "success",
"data": {
"finished": false,
"finish_reason": "not_finished",
"answer_stage": "Selecting articles",
"answer": ""
}
}
When it finishes:
{
"message": "success",
"data": {
"finished": true,
"finish_reason": "success",
"answer": "- Rates are expected to fall twice this…",
"sources": [
{
"product_id": "art-20260612-rates",
"title": "Central bank signals 2026 cuts",
"url": "https://example.com/rates"
}
]
}
}
Citations appear in answer as markdown links. sources lists those articles
in the order they are first cited.
Path Parameters
- Type: string Format: uuidquestion
_id requiredThe id returned by POST /v1/ask/summary.
Responses
- application/json
Request Example for get/v1/ask/summaries/{question_id}/summary
curl 'https://api.askmiso.com/v1/ask/summaries/123e4567-e89b-12d3-a456-426614174000/summary?api_key=YOUR_SECRET_TOKEN'
{
"message": "success",
"data": {
"question_id": "57aeb083-b943-43b1-86ab-b6108788dd50",
"answer_stage": "Generating summary",
"finished": true,
"finish_reason": "success",
"answer": "- Rates are expected to fall twice this year. [1]",
"sources": [
{
"product_id": "art-20260612-rates",
"title": "Central bank signals 2026 cuts"
}
]
}
}