API documentation

REST Endpoints

{state} is a two-letter USPS code (e.g. TX). Topics use short labels: taxes, budget, affordability, crime, immigration, ai, climate, housing, healthcare, agriculture, mining, traffic, wages, other. Hit Try it live on any endpoint to run it against real data.

{
  "pagination": {
    "page": 1,
    "page_size": 100,
    "returned_count": 100,
    "total_count": 2222,
    "total_pages": 23,
    "next_url": "https://legisdata.dev/v1/bill-search/TX?page=2",
    "prev_url": null
  },
  "data": [
    {
      "session_year": 2025,
      "bill_number": "SB 2972",
      "bill_name": "Relating to expressive activities at public institutions of higher education.",
      "key_words": "Education--Higher; Civil Remedies & Liabilities",
      "topics": ["other"],
      "chamber": "Senate",
      "chamber_type": "upper",
      "status": "passed",
      "latest_stage": "executive_signature",
      "is_resolution": false,
      "summary": "S.B. 2972 guarantees the rights of students and university employees to engage in expressive activities …",
      "bill_sponsors": [
        {
          "name": "Brandon Creighton",
          "legislator_id": "cmqtt3s1a000psf3s…",
          "legislator_url": "https://legisdata.dev/v1/legislator-detail/cmqtt3s1a000psf3s…"
        }
      ],
      "detail_url": "https://legisdata.dev/v1/bill-detail/TX/2025/SB%202972"
    }
  ]
}

{
  "data": {
    "session_year": 2025,
    "bill_number": "HB 11",
    "bill_name": "Relating to licensing reciprocity agreements …",
    "topics": ["other"],
    "chamber": "House",
    "chamber_type": "lower",
    "status": "passed",
    "latest_stage": "executive_signature",
    "is_resolution": false,
    "summary": "H.B. 11 directs the Texas Department of Licensing and Regulation …",
    "bill_text": "AN ACT relating to licensing … SECTION 1. …   (only present when include-bill-text=1)",
    "bipartisan_index": 100,
    "popularity_index": 100,
    "economic_score": 4.2,
    "social_score": 3.0,
    "velocity": 1.1,
    "bill_sponsors": [
      {
        "name": "Dade Phelan",
        "chamber": "House",
        "chamber_type": "lower",
        "party": "R",
        "legislator_id": "cmqveg29m0086sffx…",
        "legislator_url": "https://legisdata.dev/v1/legislator-detail/cmqveg29m0086sffx…"
      }
    ],
    "floor_vote_history": [
      {
        "chamber": "House",
        "chamber_type": "lower",
        "timestamp": "2025-04-24T07:00:00.000Z",
        "most_recent": true,
        "result": "pass"
      }
    ],
    "last_roll_call": [
      {
        "name": "Paul Bettencourt",
        "party": "R",
        "chamber_type": "upper",
        "vote": "yes",
        "legislator_id": "cmqtt3rq8000isf3s…",
        "legislator_url": "https://legisdata.dev/v1/legislator-detail/cmqtt3rq8000isf3s…"
      }
    ]
  }
}

{
  "pagination": {
    "page": 1,
    "page_size": 100,
    "returned_count": 18,
    "total_count": 18,
    "total_pages": 1,
    "next_url": null,
    "prev_url": null
  },
  "data": [
    {
      "name": "Bryan Hughes",
      "chamber": "Senate",
      "chamber_type": "upper",
      "party": "R",
      "district": "1",
      "legislator_id": "cmqtt3pgl0000sf3sq1u07aez",
      "legislator_url": "https://legisdata.dev/v1/legislator-detail/cmqtt3pgl0000sf3sq1u07aez"
    }
  ]
}

{
  "data": {
    "legislator_id": "cmqtt3pgl0000sf3sq1u07aez",
    "name": "Bryan Hughes",
    "chamber": "Senate",
    "chamber_type": "upper",
    "party": "R",
    "district": "1",
    "website": "https://senate.texas.gov/member.php?d=1",
    "bio": null,
    "photo_url": null,
    "economic_score": 2.8,
    "social_score": 2.8
  }
}

{
  "pagination": {
    "page": 1,
    "page_size": 100,
    "returned_count": 100,
    "total_count": 474,
    "total_pages": 5,
    "next_url": "https://legisdata.dev/v1/legislator-vote-history/cmqtt3pgl0000sf3sq1u07aez?page=2",
    "prev_url": null
  },
  "legislator": {
    "legislator_id": "cmqtt3pgl0000sf3sq1u07aez",
    "name": "Bryan Hughes",
    "legislator_url": "https://legisdata.dev/v1/legislator-detail/cmqtt3pgl0000sf3sq1u07aez"
  },
  "data": [
    {
      "session_year": 2025,
      "bill_number": "SB 2972",
      "bill_name": "Relating to expressive activities at public institutions of higher education.",
      "vote": "yes",
      "vote_date": "2025-06-01",
      "topics": ["other"],
      "status": "passed",
      "is_resolution": false,
      "summary": "S.B. 2972 guarantees the rights of students …",
      "detail_url": "https://legisdata.dev/v1/bill-detail/TX/2025/SB%202972"
    }
  ]
}

MCP server

The same dataset is exposed as a Model Context Protocol server, so assistants like Claude can query legislation as native tools — with enum-constrained inputs and token-frugal, model-shaped responses. It authenticates with the same vd_live_… key.

It also serves discovery resources (legisdata://meta/topics, states, vocab) and workflow prompts (analyze_bill, legislator_profile). Point a stdio MCP client at it:

{
  "mcpServers": {
    "legisdata": {
      "command": "node",
      "args": ["/path/to/legisdata-mcp/dist/index.js"],
      "env": {
        "LEGISDATA_API_KEY": "vd_live_…",
        "LEGISDATA_BASE_URL": "https://legisdata.dev"
      }
    }
  }
}

A hosted Streamable-HTTP endpoint is also available for remote MCP clients.

Dataset

LegisData aggregates public records from official state sources across all 50 states — bills, roll-call votes, legislators, and lifecycle events — then normalizes and enriches them with derived metrics.

What's included

• Bills — number, title, session year, sponsors, status & lifecycle stage, a plain-language summary, the full legislative text (via bill-detail), and topic labels.
• Votes — floor-vote outcomes and, where the source publishes them, per-member roll calls.
• Legislators — chamber, party, district, and vote-derived ideology scores.
• Derived metrics — bipartisan index, popularity index, economic & social scores, and legislative velocity.

Coverage & history

All 50 states are covered, with sessions currently spanning 2022–2026. Historical depth varies by state and by what each state publishes — most cover the current and prior session, and several go back further. Data is refreshed on a rolling schedule (not real-time), so expect some lag behind the official source.

Known limitations

• Roll calls vary. Some states publish only aggregate floor outcomes, not per-member votes — so last_roll_call can be empty even when a bill passed.
• Derived scores are directional. Topic labels and economic/social scores are model-derived from bill text; treat them as signal, not official classification.
• Bipartisan index needs parties. Nonpartisan chambers (e.g. Nebraska) omit it.
• Legislator scores need votes. economic_score / social_scoreare computed from a member's scored floor votes; members without qualifying votes return null.
• Historical depth is uneven across states, reflecting differences in source availability.

Pricing

Already subscribed? Sign in to manage your keys. Questions? [email protected].