Commons Votes API

parliament · Data

Data No Auth Free & Open open_data

An API that allows querying of Commons Votes data.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Return Divisions results grouped by party

Division results which meet the specified criteria grouped by parties

https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty?queryParameters.endDate=example&queryParameters.memberId=1&queryParameters.startDate=example&queryParameters.searchTerm=example&queryParameters.divisionNumber=1&queryParameters.includeWhenMemberWasTeller=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty?queryParameters.endDate=example&queryParameters.memberId=1&queryParameters.startDate=example&queryParameters.searchTerm=example&queryParameters.divisionNumber=1&queryParameters.includeWhenMemberWasTeller=true"

import requests
params = {
    "queryParameters.endDate": "example",
    "queryParameters.memberId": "1",
    "queryParameters.startDate": "example",
    "queryParameters.searchTerm": "example",
    "queryParameters.divisionNumber": "1",
    "queryParameters.includeWhenMemberWasTeller": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty');
url.searchParams.set('queryParameters.endDate', 'example');
url.searchParams.set('queryParameters.memberId', '1');
url.searchParams.set('queryParameters.startDate', 'example');
url.searchParams.set('queryParameters.searchTerm', 'example');
url.searchParams.set('queryParameters.divisionNumber', '1');
url.searchParams.set('queryParameters.includeWhenMemberWasTeller', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty")
	q := baseURL.Query()
	q.Set("queryParameters.endDate", "example")
	q.Set("queryParameters.memberId", "1")
	q.Set("queryParameters.startDate", "example")
	q.Set("queryParameters.searchTerm", "example")
	q.Set("queryParameters.divisionNumber", "1")
	q.Set("queryParameters.includeWhenMemberWasTeller", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty")
uri.query = URI.encode_www_form({
  "queryParameters.endDate" => "example",
  "queryParameters.memberId" => "1",
  "queryParameters.startDate" => "example",
  "queryParameters.searchTerm" => "example",
  "queryParameters.divisionNumber" => "1",
  "queryParameters.includeWhenMemberWasTeller" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/groupedbyparty?" . http_build_query([
    "queryParameters.endDate" => "example",
    "queryParameters.memberId" => "1",
    "queryParameters.startDate" => "example",
    "queryParameters.searchTerm" => "example",
    "queryParameters.divisionNumber" => "1",
    "queryParameters.includeWhenMemberWasTeller" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Return voting records for a Member

List of voting records for a member which meet the specified criteria.

https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting?queryParameters.skip=1&queryParameters.take=1&queryParameters.endDate=example&queryParameters.memberId=1&queryParameters.startDate=example&queryParameters.searchTerm=example&queryParameters.divisionNumber=1&queryParameters.includeWhenMemberWasTeller=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting?queryParameters.skip=1&queryParameters.take=1&queryParameters.endDate=example&queryParameters.memberId=1&queryParameters.startDate=example&queryParameters.searchTerm=example&queryParameters.divisionNumber=1&queryParameters.includeWhenMemberWasTeller=true"

import requests
params = {
    "queryParameters.skip": "1",
    "queryParameters.take": "1",
    "queryParameters.endDate": "example",
    "queryParameters.memberId": "1",
    "queryParameters.startDate": "example",
    "queryParameters.searchTerm": "example",
    "queryParameters.divisionNumber": "1",
    "queryParameters.includeWhenMemberWasTeller": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting');
url.searchParams.set('queryParameters.skip', '1');
url.searchParams.set('queryParameters.take', '1');
url.searchParams.set('queryParameters.endDate', 'example');
url.searchParams.set('queryParameters.memberId', '1');
url.searchParams.set('queryParameters.startDate', 'example');
url.searchParams.set('queryParameters.searchTerm', 'example');
url.searchParams.set('queryParameters.divisionNumber', '1');
url.searchParams.set('queryParameters.includeWhenMemberWasTeller', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting")
	q := baseURL.Query()
	q.Set("queryParameters.skip", "1")
	q.Set("queryParameters.take", "1")
	q.Set("queryParameters.endDate", "example")
	q.Set("queryParameters.memberId", "1")
	q.Set("queryParameters.startDate", "example")
	q.Set("queryParameters.searchTerm", "example")
	q.Set("queryParameters.divisionNumber", "1")
	q.Set("queryParameters.includeWhenMemberWasTeller", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting")
uri.query = URI.encode_www_form({
  "queryParameters.skip" => "1",
  "queryParameters.take" => "1",
  "queryParameters.endDate" => "example",
  "queryParameters.memberId" => "1",
  "queryParameters.startDate" => "example",
  "queryParameters.searchTerm" => "example",
  "queryParameters.divisionNumber" => "1",
  "queryParameters.includeWhenMemberWasTeller" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/membervoting?" . http_build_query([
    "queryParameters.skip" => "1",
    "queryParameters.take" => "1",
    "queryParameters.endDate" => "example",
    "queryParameters.memberId" => "1",
    "queryParameters.startDate" => "example",
    "queryParameters.searchTerm" => "example",
    "queryParameters.divisionNumber" => "1",
    "queryParameters.includeWhenMemberWasTeller" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Return a list of Divisions

List of Divisions which meet the specified criteria

https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search?queryParameters.skip=1&queryParameters.take=1&queryParameters.endDate=example&queryParameters.memberId=1&queryParameters.startDate=example&queryParameters.searchTerm=example&queryParameters.divisionNumber=1&queryParameters.includeWhenMemberWasTeller=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search?queryParameters.skip=1&queryParameters.take=1&queryParameters.endDate=example&queryParameters.memberId=1&queryParameters.startDate=example&queryParameters.searchTerm=example&queryParameters.divisionNumber=1&queryParameters.includeWhenMemberWasTeller=true"

import requests
params = {
    "queryParameters.skip": "1",
    "queryParameters.take": "1",
    "queryParameters.endDate": "example",
    "queryParameters.memberId": "1",
    "queryParameters.startDate": "example",
    "queryParameters.searchTerm": "example",
    "queryParameters.divisionNumber": "1",
    "queryParameters.includeWhenMemberWasTeller": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search');
url.searchParams.set('queryParameters.skip', '1');
url.searchParams.set('queryParameters.take', '1');
url.searchParams.set('queryParameters.endDate', 'example');
url.searchParams.set('queryParameters.memberId', '1');
url.searchParams.set('queryParameters.startDate', 'example');
url.searchParams.set('queryParameters.searchTerm', 'example');
url.searchParams.set('queryParameters.divisionNumber', '1');
url.searchParams.set('queryParameters.includeWhenMemberWasTeller', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search")
	q := baseURL.Query()
	q.Set("queryParameters.skip", "1")
	q.Set("queryParameters.take", "1")
	q.Set("queryParameters.endDate", "example")
	q.Set("queryParameters.memberId", "1")
	q.Set("queryParameters.startDate", "example")
	q.Set("queryParameters.searchTerm", "example")
	q.Set("queryParameters.divisionNumber", "1")
	q.Set("queryParameters.includeWhenMemberWasTeller", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search")
uri.query = URI.encode_www_form({
  "queryParameters.skip" => "1",
  "queryParameters.take" => "1",
  "queryParameters.endDate" => "example",
  "queryParameters.memberId" => "1",
  "queryParameters.startDate" => "example",
  "queryParameters.searchTerm" => "example",
  "queryParameters.divisionNumber" => "1",
  "queryParameters.includeWhenMemberWasTeller" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/parliament.uk/commonsvotes/v1/data/divisions.{format}/search?" . http_build_query([
    "queryParameters.skip" => "1",
    "queryParameters.take" => "1",
    "queryParameters.endDate" => "example",
    "queryParameters.memberId" => "1",
    "queryParameters.startDate" => "example",
    "queryParameters.searchTerm" => "example",
    "queryParameters.divisionNumber" => "1",
    "queryParameters.includeWhenMemberWasTeller" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Commons Votes API?

Commons Votes API is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Commons Votes API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗