Government

Data source: Stortinget (data.stortinget.no)

REST Bridge Endpoint https://context.gnist.ai/rest/stortinget/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (10)

list_sessions
get_current_representatives
get_representatives
list_parties
list_committees
get_cases
get_case
get_votes
list_topics
report_feedback

list_sessions

List all parliamentary sessions in the Norwegian Storting.

Returns sessions from 1986-87 to the current session, each identified by
a session ID like '2024-2025'. Use the session ID with other tools
(get_cases, list_committees) to query data within a specific session.

Returns:
Dict with 'count' and 'sessions' list. Each session has id, from, to dates.

Request Body

{
  "query": "example"
}

get_current_representatives

Get all current members of the Norwegian Parliament (Stortinget).

Returns the full list of sitting representatives, including their party,
county, committee assignments, and contact information.

Returns:
Dict with 'count' and 'representatives' list. Each has id, name, party,
county, committees, email, gender, and date_of_birth.

Request Body

{
  "query": "example"
}

get_representatives

Get representatives for a specific parliamentary period.

Parliamentary periods span four years (e.g. '2021-2025', '2017-2021').
Use list_sessions to find valid period IDs.

Args:
period_id: Parliamentary period (e.g. '2021-2025').

Returns:
Dict with 'count' and 'representatives' list.

Parameter	Type	Required	Description
`period_id`	`string`	required	Parliamentary period (e.g. '2021-2025').

Request Body

{
  "period_id": "example"
}

list_parties

List political parties in the Norwegian Parliament.

Without a session_id, returns all parties (historical and current).
With a session_id, returns only parties represented in that session.

Args:
session_id: Optional session (e.g. '2024-2025'). Omit for all parties.

Returns:
Dict with 'count' and 'parties' list. Each has id and name.

Parameter	Type	Required	Description
`session_id`	`any`	optional	Optional session (e.g. '2024-2025'). Omit for all parties.

Request Body

{
  "query": "example"
}

list_committees

List parliamentary committees for a given session.

Committees handle specific policy areas: finance, justice, health, energy, etc.
Each session typically has 15-18 standing committees.

Args:
session_id: Parliamentary session (e.g. '2024-2025').

Returns:
Dict with 'count' and 'committees' list. Each has id and name.

Parameter	Type	Required	Description
`session_id`	`string`	required	Parliamentary session (e.g. '2024-2025').

Request Body

{
  "session_id": "example"
}

get_cases

Get all cases (bills, propositions, questions) for a parliamentary session.

Returns all cases processed during the session, including their committee
assignment, topics, and status. Use the case ID with get_case for full
details or get_votes for voting results.

Args:
session_id: Parliamentary session (e.g. '2024-2025').

Returns:
Dict with 'count' and 'cases' list. Each has id, title, committee,
topics, and status.

Parameter	Type	Required	Description
`session_id`	`string`	required	Parliamentary session (e.g. '2024-2025').

Request Body

{
  "session_id": "example"
}

get_case

Get detailed information about a specific parliamentary case.

Returns full case details including proposers, rapporteurs, committee,
topics, and reference information.

Args:
case_id: Numeric case ID (e.g. 103839).

Returns:
Full case details with proposers, rapporteurs, topics, and committee info.

Parameter	Type	Required	Description
`case_id`	`integer`	required	Numeric case ID (e.g. 103839).

Request Body

{
  "case_id": 1
}

get_votes

Get voting results for a parliamentary case.

Returns all votes taken on the case, including for/against counts,
whether it passed, and the specific motion being voted on.

Args:
case_id: Numeric case ID (e.g. 103839).

Returns:
Dict with 'count' and 'votes' list. Each vote has for/against/absent
counts, passed status, and the motion topic.

Parameter	Type	Required	Description
`case_id`	`integer`	required	Numeric case ID (e.g. 103839).

Request Body

{
  "case_id": 1
}

list_topics

List the parliamentary topic taxonomy.

Returns the two-level hierarchy of policy topics used to classify cases.
Main topics include areas like Energy, Finance, Defense, Education, Health.
Each main topic has subtopics for more specific classification.

Returns:
Dict with 'count' and 'topics' list. Each has id, name, is_main_topic,
and a subtopics list.

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/stortinget/get_representatives" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"period_id": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/stortinget/get_representatives",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "period_id": "example"
},
)
print(resp.json())