List forecasts on a dashboard
List dashboards and read their forecasts, each with its latest run.
A dashboard is a curated list of forecasts, as in the Mantic web app.
List dashboards
List dashboards with GET /dashboards:
curl "https://api.mantic.com/dashboards" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"dashboards": [
{
"id": 42,
"title": "UK macro outlook",
"description": "Forecasts monitored by the economics team"
}
],
"next": null
}Dashboards are listed most recently updated first and are paginated. Use a dashboard's id in the paths below.
To find a dashboard by topic, send search. match_questions=true also searches the titles of its forecasts, more slowly:
curl --get "https://api.mantic.com/dashboards" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "search=UK inflation" \
--data-urlencode "match_questions=true"Include the latest runs
List the forecasts on dashboard 42 with their latest runs. Set show_forecasts=true; without it, your organisation's default decides whether runs come back redacted:
curl --get "https://api.mantic.com/dashboards/42/questions" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "show_forecasts=true"An abridged response looks like this:
{
"questions": [
{
"id": 123,
"title": "Will UK CPI inflation be below 2.5% in December 2026?",
"latest_forecast": {
"id": 987,
"type": "event",
"probability": 0.64
},
"tags": ["Economics", "United Kingdom"]
}
],
"next": {
"added_at": "2026-09-18T10:42:31Z",
"id": 123
}
}latest_forecast is null for a forecast with no completed run yet. Otherwise its fields depend on its type; see Read a forecast's latest run.
Page through a dashboard's forecasts
Forecasts are listed most recently added first:
from mantic_client import ManticClient, paginate
client = ManticClient()
try:
path = "/dashboards/DASHBOARD_ID/questions"
for question in paginate(client, path, "questions", {"show_forecasts": "true"}):
print(question["id"], question["title"])
finally:
client.close()Search within a dashboard
Send search to rank the forecasts on one dashboard by relevance to a topic:
curl --get "https://api.mantic.com/dashboards/42/questions" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "search=interest rates" \
--data-urlencode "show_forecasts=true"Search returns a single page of up to 25 forecasts.