FiscalNote Bills API
Access legislation and bill data from federal, state, and international jurisdictions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/fiscalnote:fiscalnote-bills-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: FiscalNote AppData Bills API
description: The FiscalNote AppData API provides access to FiscalNote's data on legislation and regulations, both past and present, in the United States and globally. It also exposes organizational data from the FiscalNote platform including issues and labels. Developers can use the API to integrate legislative tracking, regulatory monitoring, and policy analysis capabilities into their own applications and workflows.
version: '1.0'
contact:
name: FiscalNote Support
url: https://fiscalnote.com/contact
termsOfService: https://fiscalnote.com/terms
servers:
- url: https://api.fiscalnote.com
description: Production Server
security:
- apiKey: []
tags:
- name: Bills
description: Access legislation and bill data from federal, state, and international jurisdictions.
paths:
/appdata/v1/bills:
get:
operationId: listBills
summary: FiscalNote List bills
description: Returns a paginated list of bills and legislative measures. Supports filtering by jurisdiction, session, status, keyword search, and other criteria. Results include both current and historical legislation from the US and international jurisdictions.
tags:
- Bills
parameters:
- $ref: '#/components/parameters/jurisdictionParam'
- $ref: '#/components/parameters/sessionParam'
- $ref: '#/components/parameters/statusParam'
- $ref: '#/components/parameters/queryParam'
- $ref: '#/components/parameters/limitParam'
- $ref: '#/components/parameters/offsetParam'
- $ref: '#/components/parameters/updatedSinceParam'
responses:
'200':
description: A paginated list of bill records.
content:
application/json:
schema:
$ref: '#/components/schemas/BillListResponse'
'401':
description: Authentication credentials are missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/appdata/v1/bills/{billId}:
get:
operationId: getBill
summary: FiscalNote Get bill by ID
description: Returns detailed information about a specific bill including its full text, sponsors, committee assignments, vote history, and current status.
tags:
- Bills
parameters:
- name: billId
in: path
required: true
description: The unique identifier of the bill.
schema:
type: string
responses:
'200':
description: Detailed bill record.
content:
application/json:
schema:
$ref: '#/components/schemas/Bill'
'401':
description: Authentication credentials are missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Bill not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
parameters:
limitParam:
name: limit
in: query
required: false
description: Maximum number of results to return per page.
schema:
type: integer
minimum: 1
maximum: 100
default: 25
sessionParam:
name: session
in: query
required: false
description: Filter by legislative session identifier.
schema:
type: string
jurisdictionParam:
name: jurisdiction
in: query
required: false
description: Filter by jurisdiction code such as US, US-CA, GB, or EU.
schema:
type: string
updatedSinceParam:
name: updatedSince
in: query
required: false
description: Return only records updated after this ISO 8601 datetime.
schema:
type: string
format: date-time
statusParam:
name: status
in: query
required: false
description: Filter by legislation status.
schema:
type: string
offsetParam:
name: offset
in: query
required: false
description: Number of results to skip for pagination.
schema:
type: integer
minimum: 0
default: 0
queryParam:
name: q
in: query
required: false
description: Full-text search query to filter results.
schema:
type: string
schemas:
Pagination:
type: object
description: Pagination metadata for list responses.
properties:
total:
type: integer
description: Total number of records matching the query.
limit:
type: integer
description: Maximum number of records returned per page.
offset:
type: integer
description: Number of records skipped.
hasMore:
type: boolean
description: Indicates whether more records are available.
BillListResponse:
type: object
description: Paginated response containing a list of bills.
properties:
data:
type: array
items:
$ref: '#/components/schemas/Bill'
pagination:
$ref: '#/components/schemas/Pagination'
Bill:
type: object
description: A bill or legislative measure from a federal, state, or international jurisdiction.
properties:
id:
type: string
description: Unique identifier for the bill.
title:
type: string
description: Official title of the bill.
number:
type: string
description: Bill number.
type:
type: string
description: Type of legislation.
jurisdiction:
type: string
description: Jurisdiction code where the bill was introduced.
session:
type: string
description: Legislative session identifier.
status:
type: string
description: Current status of the bill.
introducedDate:
type: string
format: date
description: Date the bill was introduced.
lastActionDate:
type: string
format: date
description: Date of the most recent action.
lastAction:
type: string
description: Description of the most recent action.
sponsors:
type: array
description: List of sponsors and co-sponsors.
items:
$ref: '#/components/schemas/SponsorRef'
subjects:
type: array
description: Subject tags associated with the bill.
items:
type: string
summary:
type: string
description: Summary text of the bill.
url:
type: string
format: uri
description: URL to the bill on the FiscalNote platform.
createdAt:
type: string
format: date-time
description: Timestamp when the record was created.
updatedAt:
type: string
format: date-time
description: Timestamp when the record was last updated.
Error:
type: object
description: Error response returned when a request fails.
properties:
code:
type: integer
description: HTTP status code.
message:
type: string
description: Human-readable error message.
SponsorRef:
type: object
description: A reference to a bill sponsor.
properties:
id:
type: string
description: Unique identifier of the sponsor.
name:
type: string
description: Full name of the sponsor.
role:
type: string
description: Role such as primary or cosponsor.
securitySchemes:
apiKey:
type: apiKey
in: header
name: Authorization
description: API key provided by FiscalNote. Include in the Authorization header of each request.
externalDocs:
description: FiscalNote AppData API Documentation
url: https://apidocs.fiscalnote.com/apis