Skip to main content
The Parties API provides access to political parties represented in city councils, including their branding and identification.

​
List parties

GET /api/cities/{cityId}/parties Returns all political parties represented in a specified city’s council.

​
Parameters

​
cityId
string
required
The unique identifier of the city

​
Response

Returns an array of Party objects.
​
id
string
Unique identifier for the party
​
name
string
Full party name in Greek
​
name_en
string
Full party name in English
​
name_short
string
Abbreviated party name in Greek
​
name_short_en
string
Abbreviated party name in English
​
colorHex
string
Brand color in hexadecimal format (e.g., “#FF5733”)
URL to party logo image
​
cityId
string
ID of the associated city
​
createdAt
string
ISO 8601 timestamp of record creation
​
updatedAt
string
ISO 8601 timestamp of last update

​
Example request

curl https://api.opencouncil.gr/api/cities/athens/parties

​
Example response

[
  {
    "id": "cly123abc",
    "name": "Νέα Δημοκρατία",
    "name_en": "New Democracy",
    "name_short": "ΝΔ",
    "name_short_en": "ND",
    "colorHex": "#0066CC",
    "logo": "https://example.com/nd-logo.png",
    "cityId": "athens",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": "cly456def",
    "name": "ΣΥΡΙΖΑ",
    "name_en": "SYRIZA",
    "name_short": "ΣΥΡ",
    "name_short_en": "SYR",
    "colorHex": "#CC0000",
    "logo": "https://example.com/syriza-logo.png",
    "cityId": "athens",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  }
]

​
Get party

GET /api/cities/{cityId}/parties/{partyId} Returns details for a specific political party.

​
Parameters

​
cityId
string
required
The unique identifier of the city
​
partyId
string
required
The unique identifier of the party

​
Response

Returns a Party object with the same fields as the list endpoint.

​
Example request

curl https://api.opencouncil.gr/api/cities/athens/parties/cly123abc

​
Example response

{
  "id": "cly123abc",
  "name": "Νέα Δημοκρατία",
  "name_en": "New Democracy",
  "name_short": "ΝΔ",
  "name_short_en": "ND",
  "colorHex": "#0066CC",
  "logo": "https://example.com/nd-logo.png",
  "cityId": "athens",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

​
Error responses

​
Party not found (404)

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Party not found"
  }
}

​
Server error (500)

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Failed to fetch party"
  }
}

​
Use cases

Use party IDs to filter search results or meeting transcripts to find discussions by members of specific parties.
Use the colorHex and logo fields to create visually branded displays of council composition and speaking statistics.
Track which parties are most active in discussions or analyze voting patterns by party affiliation.

People

Get council member information

Search

Filter search results by party

Build docs developers (and LLMs) love

Get started for freeTalk to us