{ "openapi": "3.1.0", "info": { "title": "Tamilnadu API", "version": "0.1.0", "description": "Provisional Tamil Nadu Assembly general-election archive, 1967–2026. All 234 constituency IDs present each year; full official candidate verification pending. See coverage before relying on completeness. All routes are read-only, public, and domain-independent." }, "servers": [ { "url": "/api/v1", "description": "API on the current deployment origin" } ], "paths": { "/": { "get": { "summary": "API overview", "operationId": "api_overview", "parameters": [], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/health": { "get": { "summary": "Health check", "operationId": "health_check", "parameters": [], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "const": "ok" }, "elections": { "type": "integer" }, "result_rows": { "type": "integer" }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/coverage": { "get": { "summary": "Coverage audit", "operationId": "coverage_audit", "parameters": [], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/sources": { "get": { "summary": "Source manifest", "operationId": "source_manifest", "parameters": [], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections": { "get": { "summary": "Election list", "operationId": "election_list", "parameters": [], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}": { "get": { "summary": "Election overview", "operationId": "election_overview", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/constituencies": { "get": { "summary": "Constituency summaries", "operationId": "constituency_summaries", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 160 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 } }, { "name": "district", "in": "query", "schema": { "type": "string" }, "description": "Exact case-insensitive source district; 2021/2026 only" } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" } }, "meta": { "$ref": "#/components/schemas/Meta" }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "data", "meta", "pagination" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/constituencies/{id}/results": { "get": { "summary": "Constituency results", "operationId": "constituency_results", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/results": { "get": { "summary": "Election results", "operationId": "election_results", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 160 } }, { "name": "party", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Exact case-insensitive source label" }, { "name": "status", "in": "query", "required": false, "schema": { "enum": [ "won", "lost", "nota", "unresolved" ] } }, { "name": "constituency_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Result" } }, "meta": { "$ref": "#/components/schemas/Meta" }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "data", "meta", "pagination" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/winners": { "get": { "summary": "Election winners", "operationId": "election_winners", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 160 } }, { "name": "party", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Exact case-insensitive source label" }, { "name": "status", "in": "query", "required": false, "schema": { "enum": [ "won", "lost", "nota", "unresolved" ] } }, { "name": "constituency_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Result" } }, "meta": { "$ref": "#/components/schemas/Meta" }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "data", "meta", "pagination" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/losers": { "get": { "summary": "Election losers", "operationId": "election_losers", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 160 } }, { "name": "party", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Exact case-insensitive source label" }, { "name": "status", "in": "query", "required": false, "schema": { "enum": [ "won", "lost", "nota", "unresolved" ] } }, { "name": "constituency_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Result" } }, "meta": { "$ref": "#/components/schemas/Meta" }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "data", "meta", "pagination" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/parties": { "get": { "summary": "Party totals", "operationId": "party_totals", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" } }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/elections/{year}/export.csv": { "get": { "summary": "CSV export", "operationId": "csv_export", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 160 } }, { "name": "party", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Exact case-insensitive source label" }, { "name": "status", "in": "query", "required": false, "schema": { "enum": [ "won", "lost", "nota", "unresolved" ] } }, { "name": "constituency_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "text/csv": { "schema": { "type": "string" } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/candidates": { "get": { "summary": "Candidate result search", "operationId": "candidate_result_search", "parameters": [ { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 160 } }, { "name": "party", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Exact case-insensitive source label" }, { "name": "status", "in": "query", "required": false, "schema": { "enum": [ "won", "lost", "nota", "unresolved" ] } }, { "name": "constituency_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Result" } }, "meta": { "$ref": "#/components/schemas/Meta" }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "data", "meta", "pagination" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/records/{record_id}": { "get": { "summary": "Result record", "operationId": "result_record", "parameters": [ { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Result" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/compare": { "get": { "summary": "Modern constituency comparison", "operationId": "modern_constituency_comparison", "parameters": [ { "name": "from", "in": "query", "required": true, "schema": { "enum": [ 2011, 2016, 2021, 2026 ] } }, { "name": "to", "in": "query", "required": true, "schema": { "enum": [ 2011, 2016, 2021, 2026 ] } }, { "name": "constituency_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/results": { "get": { "summary": "Easy constituency results shortcut", "operationId": "easy_constituency_results", "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] } }, { "name": "constituency_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 234 } } ], "responses": { "200": { "description": "Collected source data; official verification pending", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Invalid query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Unsafe boundary comparison", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "description": "Supply year and constituency_id to get the full seat summary and every imported result row; no pagination." } }, "/elections/{year}/districts": { "get": { "summary": "Source-year district groups (2021 and 2026 only)", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "enum": [ 2021, 2026 ] } } ], "responses": { "200": { "description": "District names, seat IDs, counts; null marks missing labels" }, "409": { "description": "District data unavailable for this year" } } } } }, "components": { "schemas": { "Meta": { "type": "object", "properties": { "dataset_version": { "type": "string" }, "release_status": { "const": "provisional" }, "official_row_verification": { "const": "pending" } }, "required": [ "dataset_version", "release_status", "official_row_verification" ] }, "Pagination": { "type": "object", "properties": { "page": { "type": "integer" }, "limit": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } }, "required": [ "page", "limit", "total", "pages" ] }, "Result": { "type": "object", "properties": { "id": { "type": "string", "description": "Source-scoped result ID, not person ID" }, "year": { "type": "integer", "enum": [ 1967, 1971, 1977, 1980, 1984, 1989, 1991, 1996, 2001, 2006, 2011, 2016, 2021, 2026 ] }, "constituency_id": { "type": "integer", "minimum": 1, "maximum": 234 }, "constituency_name": { "type": "string" }, "candidate_name": { "type": "string" }, "party": { "type": "string" }, "votes": { "type": "integer", "minimum": 0 }, "general_votes": { "type": [ "integer", "null" ] }, "postal_votes": { "type": [ "integer", "null" ] }, "rank": { "type": [ "integer", "null" ] }, "status": { "enum": [ "won", "lost", "nota", "unresolved" ] }, "is_nota": { "type": "boolean" }, "vote_share_pct": { "type": [ "number", "null" ] }, "verification_status": { "const": "pending_official_row_verification" }, "source_id": { "type": "string" }, "source_row": { "type": "integer" }, "quality_flags": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "year", "constituency_id", "candidate_name", "party", "votes", "status", "verification_status", "source_id", "quality_flags" ] }, "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string" } } }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }