API documentation

One OpenAPI document per API version.

VersionStatusSunsetSpec
legacy current — openapi.json

Import into a client

The openapi.json above is the machine-readable contract. Import its URL into Apidog, Postman, Insomnia or Swagger UI, or generate a client from it directly. 

https://api.digitaldemocracy.org/docs/legacy/openapi.json

Before you start

Every endpoint needs an x-api-key header. The version is the first path segment and the jurisdiction the second — both required. 

curl -H "x-api-key: $KEY" \
  https://api.digitaldemocracy.org/legacy/ca/bill/CA_202320240SB233

GET /whoami reports which resources, versions and jurisdictions your key is granted, which is the fastest way to explain a 403.