/api/v1

Documentation

One REST API for every current US officeholder — no key required to explore.

Quick start

The base URL is https://civiclens.io/api/v1. Every endpoint is a GET that returns JSON — this one selects a single Texas House seat.

GET /api/v1/members

$ curl "https://civiclens.io/api/v1/members\
?state=tx&chamber=lower&district=30"

{
  "id": "ocd-person/7f1c9e2a-41b6-4c8d-9a3e-5d2f8b6c0e14",
  "name": "Dana Whitfield",
  "party": "Republican",
  "government": {
    "level": "state",
    "chamber": "lower",
    "district": "30",
    "stateCode": "tx"
  },
  "contactInfo": { "email": "dana.whitfield@house.texas.gov" }
}

First time here? Start with Getting started.

Guides

Learn the API

Getting started

Your first call in 60 seconds.

Read the guide →

Filtering members

Slice the full dataset by state, chamber, district, party or name — filters combine.

Read the guide →

The vacancy feed

Seats are vacated explicitly, with a reason and a date — poll one endpoint to know.

Read the guide →

Data standards

What is true of every published field.

Read the guide →

Authentication

Where keys stand today.

Read the guide →

Endpoints

Every endpoint

Members

GET /membersSearch government members GET /members/{id}Get a single member

Vacancies

GET /vacanciesList currently-vacant legislative seats

By jurisdiction

GET /governments/us/federal/{state}/legislature/currentGet a state’s full congressional delegation GET /governments/us/federal/{state}/legislature/house/currentGet current U.S. House Representatives for a state GET /governments/us/federal/{state}/legislature/senate/currentGet current U.S. Senators for a state GET /governments/us/states/{state}/executive/currentGet all current state executive officeholders GET /governments/us/states/{state}/executive/governor/currentGet current state governor GET /governments/us/states/{state}/judicial/currentGet current state judicial officeholders GET /governments/us/states/{state}/legislature/currentGet a state’s full legislature GET /governments/us/states/{state}/legislature/lower/currentGet current state house members GET /governments/us/states/{state}/legislature/unicameral/currentGet current unicameral legislature members GET /governments/us/states/{state}/legislature/upper/currentGet current state senate members

Roles

GET /rolesGet government role definitions

Statistics

GET /statisticsGet aggregated statistics GET /statistics/healthAPI health statistics GET /statistics/overviewStatistics overview

Specification

GET /openapi.jsonGet this OpenAPI document

Reference

Field coverage

Per-field coverage figures, measured on a live sample and refreshed continuously.

See the spec sheet →

Machine-readable

The full OpenAPI document is served at /api/v1/openapi.json with permissive CORS. Every page here renders from it, so the two cannot disagree.