{
  "version": "1.0",
  "site": "https://indiaelections.org",
  "actions": [
    {
      "id": "search-india-elections",
      "name": "Search India Elections Database",
      "description": "Search for candidates, parties, constituencies, or states. Returns an HTML results page with links to matching profiles.",
      "method": "declarative",
      "endpoint": "/search",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "parameters": {
        "required": [
          {
            "name": "q",
            "type": "string",
            "description": "Search query: candidate name, party name, constituency name, or state name"
          }
        ]
      },
      "example": "https://indiaelections.org/search?q=suvendu+adhikari"
    },
    {
      "id": "get-candidate-profile",
      "name": "Get Candidate Affidavit Profile",
      "description": "Get a candidate's declared assets, liabilities, criminal cases, education, and election history. Data sourced from official ECI nomination affidavits.",
      "method": "declarative",
      "endpoint": "/candidates/{state}/{constituency}/{candidate}",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "example": "https://indiaelections.org/candidates/west-bengal/nandigram/suvendu-adhikari"
    },
    {
      "id": "get-ls-candidate-profile",
      "name": "Get Lok Sabha MP Candidate Profile",
      "description": "Get an MP candidate's declared assets, liabilities, criminal cases, MPLADS fund utilization, and election history.",
      "method": "declarative",
      "endpoint": "/lok-sabha/candidates/{state}/{constituency}/{candidate}",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "example": "https://indiaelections.org/lok-sabha/candidates/west-bengal/kolkata-dakshin/abhijit-das"
    },
    {
      "id": "get-state-election-results",
      "name": "Get State Assembly Election Results",
      "description": "Get all constituency-wise results for a state Vidhan Sabha election cycle — winner, party, votes polled, margin of victory.",
      "method": "declarative",
      "endpoint": "/states/{state}/{year}",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "example": "https://indiaelections.org/states/west-bengal/2026"
    },
    {
      "id": "get-constituency-results",
      "name": "Get Constituency Election History",
      "description": "Get historical winners, vote tallies, margins, and full candidate list for an assembly constituency.",
      "method": "declarative",
      "endpoint": "/constituency/{state}/{constituency}",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "example": "https://indiaelections.org/constituency/west-bengal/nandigram"
    },
    {
      "id": "get-party-profile",
      "name": "Get Political Party Profile",
      "description": "Get a party's MLA seat wins, MP wins, CM count, election symbol, colors, and alliance history.",
      "method": "declarative",
      "endpoint": "/parties/{abbr}",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "example": "https://indiaelections.org/parties/bjp"
    },
    {
      "id": "get-chief-ministers",
      "name": "Get Current Chief Ministers",
      "description": "Get the current chief ministers of all Indian states and union territories with party affiliation and tenure duration.",
      "method": "declarative",
      "endpoint": "/chief-ministers",
      "http_method": "GET",
      "auth_required": false,
      "guest_accessible": true,
      "example": "https://indiaelections.org/chief-ministers"
    }
  ]
}