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
  • question_id
    Type: string Format: uuid
    required

    The 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"
      }
    ]
  }
}