{ "openapi": "3.0.1", "info": { "title": "Legislation Tracking API: Congress, State and EU Bills, Votes", "description": "Track federal, state, local and EU legislation with the Quorum API: search bills by keyword, region, status and sponsor, plus summaries, cosponsors, amendments, roll call votes, legislators, staffers, committees and legislative documents. Bring your own key.", "version": "0.1", "x-build-id": "cq5Jg0NehOWD7ugs4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~legislation-tracking-bills-votes-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-legislation-tracking-bills-votes-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nabeelbaghoor~legislation-tracking-bills-votes-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-legislation-tracking-bills-votes-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nabeelbaghoor~legislation-tracking-bills-votes-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-legislation-tracking-bills-votes-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to get", "enum": [ "bills", "billsById", "billSummaries", "billSponsors", "amendments", "votes", "votesById", "officials", "officialsById", "personRoles", "committees", "documents" ], "type": "string", "description": "Bills searches federal, state, local and EU bills (GET /newbill/). Bills by ID reads single bills. Bill summaries and Bill sponsors and cosponsors read the summaries and sponsor records of given bills. Bill amendments and Roll call votes search amendments and votes, optionally for given bills. Officials and staffers searches legislators, executives and staff; Roles and offices held lists the roles of given people. Committees and caucuses and Legislative documents search committees and documents such as press releases, floor statements, CRS reports and EU documents. Every request is one call on your Quorum API access.", "default": "bills" }, "searchText": { "title": "Search text", "type": "string", "description": "Bills, amendments, votes, officials, committees and documents. Keywords or a phrase, sent as quick_search or advanced_search (votes and documents offer advanced search only). Leave empty to filter only." }, "searchMethod": { "title": "Search method", "enum": [ "quick", "advanced" ], "type": "string", "description": "Bills, amendments, officials and committees. Quick search answers faster; advanced search uses the most comprehensive method Quorum has for the dataset and can take a little longer.", "default": "quick" }, "regions": { "title": "Regions (legislatures)", "type": "array", "description": "Bills, amendments, votes, officials, roles, committees and documents. US Congress, any of the 50 state legislatures, DC and territories, US local, the European Union and other national parliaments, sent as region__in (most_recent_region__in for officials).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64", "65", "66", "67", "68", "69", "70", "71", "72", "73", "74", "75", "76", "77", "78", "79", "80", "81", "82", "83", "84", "85", "86", "87", "88", "89", "90", "91", "92", "93", "94", "95", "96", "97", "98", "99", "100", "101", "102", "103", "104", "105", "106", "107", "108", "109", "110", "200", "201", "202", "203", "204", "205", "206", "207", "208", "209", "210", "211", "212", "213", "214", "215", "216", "217", "218", "219", "220", "221", "222", "223", "224", "225", "1000" ], "enumTitles": [ "US Congress", "Alabama Legislature", "Alaska State Legislature", "Arizona State Legislature", "Arkansas General Assembly", "California State Legislature", "Colorado General Assembly", "Connecticut General Assembly", "Delaware General Assembly", "Council of the District of Columbia", "Florida Legislature", "Georgia General Assembly", "Hawaii State Legislature", "Idaho State Legislature", "Illinois General Assembly", "Indiana General Assembly", "Iowa General Assembly", "Kansas State Legislature", "Kentucky General Assembly", "Louisiana Legislature", "Maine Legislature", "Maryland General Assembly", "Massachusetts General Court", "Michigan Legislature", "Minnesota State Legislature", "Mississippi Legislature", "Missouri General Assembly", "Montana Legislature", "Nebraska Legislature", "Nevada Legislature", "New Hampshire General Court", "New Jersey Legislature", "New Mexico Legislature", "New York Legislature", "North Carolina General Assembly", "North Dakota Legislative Assembly", "Ohio General Assembly", "Oklahoma Legislature", "Oregon Legislative Assembly", "Pennsylvania General Assembly", "Legislative Assembly of Puerto Rico", "Rhode Island General Assembly", "South Carolina Legislature", "South Dakota State Legislature", "Tennessee General Assembly", "Texas Legislature", "Utah State Legislature", "Vermont General Assembly", "Virginia General Assembly", "Washington State Legislature", "West Virginia Legislature", "Wisconsin State Legislature", "Wyoming State Legislature", "Alabama Local", "Alaska Local", "Arizona Local", "Arkansas Local", "California Local", "Colorado Local", "Connecticut Local", "Delaware Local", "District of Columbia Local", "Florida Local", "Georgia Local", "Hawaii Local", "Idaho Local", "Illinois Local", "Indiana Local", "Iowa Local", "Kansas Local", "Kentucky Local", "Louisiana Local", "Maine Local", "Maryland Local", "Massachusetts Local", "Michigan Local", "Minnesota Local", "Mississippi Local", "Missouri Local", "Montana Local", "Nebraska Local", "Nevada Local", "New Hampshire Local", "New Jersey Local", "New Mexico Local", "New York Local", "North Carolina Local", "North Dakota Local", "Ohio Local", "Oklahoma Local", "Oregon Local", "Pennsylvania Local", "Puerto Rico Local", "Rhode Island Local", "South Carolina Local", "South Dakota Local", "Tennessee Local", "Texas Local", "Utah Local", "Vermont Local", "Virginia Local", "Washington Local", "West Virginia Local", "Wisconsin Local", "Wyoming Local", "European Union", "Legislature of the Virgin Islands", "American Samoa Fono", "Legislature of Guam", "Northern Mariana Islands Commonwealth Legislature", "Parliament of Australia", "Parliament of Canada", "General Congress of the United Mexican States", "The German Bundestag", "Parliament of the United Kingdom of Great Britain and Northern Ireland", "French Parliament", "Parliament of India", "Italian Parliament", "Federal Government of Brazil", "National People's Congress of the People's Republic of China", "National Diet of Japan", "Las Cortes Generales", "Consultative Assembly of Saudi Arabia", "Congress of the Republic of Colombia", "Parliament of South Africa", "The Oireachtas", "Parliament of Poland", "Folketing", "Riksdag", "States General of the Netherlands", "National Assembly of Thailand", "National Assembly of the Republic of Korea", "People's Consultative Assembly of the Republic of Indonesia", "Parliament of Singapore", "The National Congress of Argentina", "Legislative Yuan", "Global" ] } }, "billTypes": { "title": "Bill types", "type": "array", "description": "Bills only. Such as H.R., S., H.Res., joint and concurrent resolutions, EU regulations, directives and decisions, and nominations.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13" ], "enumTitles": [ "H.Res.", "S.", "H.R.", "S.Res.", "H.Con.Res.", "S.Con.Res.", "H.J.Res.", "S.J.Res.", "Regulation", "Directive", "Decision", "Nomination", "Other" ] } }, "billStatuses": { "title": "Bill status", "type": "array", "description": "Bills only. The general status, such as introduced, out of committee, passed one or both chambers, sent to the executive, enacted or failed, and the EU legislative procedure stages.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "8", "9", "10", "11", "12", "13", "14", "101", "102", "103", "104", "105", "106", "107", "108", "109", "110" ], "enumTitles": [ "Introduced or Prefiled", "Out of Committee", "Passed Original Chamber", "Passed Second Chamber", "Sent to Executive", "Enacted", "Other", "Failed", "Received", "Left Committee", "Confirmed", "Returned", "Withdrawn", "Proposed by the European Commission", "First reading by the European Parliament", "First reading by the European Council", "Second reading by the European Parliament", "Second reading by the European Council", "Conciliation Committee", "Third Reading", "Adoption", "Failed", "Unknown" ] } }, "billLabel": { "title": "Bill number", "type": "string", "description": "Bills only. A bill label or part of one, such as H.R. 1 or SB 54, matched case insensitively (label__icontains)." }, "parties": { "title": "Party", "type": "array", "description": "Bills and amendments (primary party of the sponsors) and officials (most recent party), including the European Parliament groups.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21" ], "enumTitles": [ "Non-Designated", "Democrat", "Republican", "Independent", "Other", "Both", "Bipartisan", "European People's Party", "Progressive Alliance of Socialists and Democrats", "European Conservatives and Reformists Group", "Renew Europe Group", "The Left group in the European Parliament", "The Greens-European Free Alliance", "Europe of Freedom and Direct Democracy", "Identity and Democracy Group", "Non-Inscrits", "New Progressive Party", "Popular Democratic Party", "Puerto Rican Independence Party", "Working People's Party", "Libertarian" ] } }, "year": { "title": "Year", "minimum": 1789, "maximum": 2100, "type": "integer", "description": "Bills (introduced), amendments (offered), votes (created) and documents (dated) in this year, sent as the documented __year qualifier." }, "month": { "title": "Month", "minimum": 1, "maximum": 12, "type": "integer", "description": "Optional, with the year. Month 1 to 12, sent as the documented __month qualifier." }, "billIds": { "title": "Bill IDs", "type": "array", "description": "Numeric Quorum bill IDs, one per line, from the id column of a Bills run. Required for Bills by ID and Bill summaries; optional for Bill sponsors, Bill amendments and Roll call votes, which then run once per bill.", "items": { "type": "string" } }, "voteIds": { "title": "Vote IDs", "type": "array", "description": "Votes by ID only. Numeric Quorum vote IDs, one per line.", "items": { "type": "string" } }, "personIds": { "title": "Person IDs", "type": "array", "description": "Numeric Quorum person IDs, one per line, such as 300087. Required for Officials by ID and Roles and offices held; optional for Bills (bills they sponsor), Bill sponsors (bills they sponsor or cosponsor) and Legislative documents (documents from them).", "items": { "type": "string" } }, "chambers": { "title": "Chamber", "type": "array", "description": "Roll call votes only. Senate, House, Joint or Executive.", "items": { "type": "string", "enum": [ "1", "2", "3", "4" ], "enumTitles": [ "Senate", "House", "Joint", "Executive" ] } }, "amendmentStatuses": { "title": "Amendment status", "type": "array", "description": "Bill amendments only. Offered, passed, failed or withdrawn.", "items": { "type": "string", "enum": [ "1", "2", "3", "4" ], "enumTitles": [ "Offered", "Passed", "Failed", "Withdrawn" ] } }, "sponsorTypes": { "title": "Sponsor type", "type": "array", "description": "Bill sponsors only. Primary sponsor, original or other cosponsor, author, and the EU rapporteur and committee roles.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "101", "102", "103", "104", "105", "106" ], "enumTitles": [ "Primary Sponsor", "Original Cosponsor", "Other Cosponsor", "Author", "Organization nominated to serve in", "Rapporteur", "Shadow Rapporteur", "Rapporteur For Opinion", "Responsible Committee", "Committee For Opinion", "Council Configuration" ] } }, "personTypes": { "title": "Person type", "type": "array", "description": "Officials and staffers only. Member, staffer, executive, local member, judiciary, press contact or person.", "items": { "type": "string", "enum": [ "1", "2", "3", "6", "7", "8", "9" ], "enumTitles": [ "Member", "Staffer", "Executive", "Local Member", "Person", "Judiciary", "Press Contact" ] } }, "currentOnly": { "title": "Current only", "type": "boolean", "description": "Officials and roles only. Sends current=true so only people and roles in office now are returned. Untick to include former ones.", "default": true }, "committeeTypes": { "title": "Committee type", "type": "array", "description": "Committees only. Senate, House, Joint, and European Parliament committees, intergroups and committees of inquiry.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10" ], "enumTitles": [ "Senate", "Joint", "House", "Senate", "House", "Joint", "Parliamentary Committee", "Parliament Intergroup", "Committee of Inquiry", "Special Parliament Committee" ] } }, "includeObsoleteCommittees": { "title": "Include obsolete committees", "type": "boolean", "description": "Committees only. Left unticked, obsolete=false keeps committees that no longer exist out of the results.", "default": false }, "documentTypes": { "title": "Document type", "type": "array", "description": "Legislative documents only. Such as press releases, floor statements, Dear Colleague letters, CRS, CBO and GAO reports, executive orders, committee reports and EU documents.", "items": { "type": "string", "enum": [ "5", "6", "7", "9", "10", "17", "18", "21", "22", "23", "24", "25", "27", "34", "35", "38", "39", "40", "41", "43", "44", "45", "46", "47", "50", "52", "53", "54", "55", "56", "57", "64", "65", "67", "68", "71", "73", "74", "101", "1001", "1002", "1003", "1004", "1005", "1006", "1007", "1008", "1009", "1010", "1011", "1012", "1013", "1014", "1015", "1016", "1017", "1018", "1019" ], "enumTitles": [ "Press Release", "Tweet", "Floor Statement", "Facebook Post", "House Dear Colleague Letter", "Committee Document", "House Proxy Letter", "GAO Report", "CRS Report", "CBO Report", "Newsletters to Constituents", "State Executive Order", "State Bill Supporting Document", "Committee Report", "Live Transcript Document", "Medium Post", "Instagram Post", "Letter", "YouTube Video", "Speech", "State of the State Address", "Statements in Committee Hearings", "Statements from Presidential Appearances", "Verified Transcript for Statements in Committee Hearings", "Parliamentary Question", "Vote Explanation", "Written Declaration", "Motion for Resolution", "Committee Opinion", "Speech in Plenary", "Legislation Supporting Document", "Executive Order", "White House Press Briefing", "White House Proclamation", "Presidential Memorandum", "Presidential Nomination", "Presidential Action", "White House Speech or Remarks", "Regulatory Document", "EPRS Report", "Statement of Administration Policy", "Amendment", "Plenary Report", "Staff Working Document", "Consultation Document", "Communication", "Voting Result", "General Approach", "National Parliament Document", "Conclusion", "Committee Agenda", "Plenary Agenda", "Council Meeting Agenda", "Council Meeting Minutes", "Council Committee Meeting Agenda", "Council Committee Meeting Minutes", "Other Local Meeting Agenda", "Other Local Meeting Minutes" ] } }, "expandBillDetails": { "title": "Expand bill status and sponsor", "type": "boolean", "description": "Bills only. Sends dehydrate=display_status,sponsor_name so rows carry the readable status and the sponsor name.", "default": true }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most rows this run returns and charges for. Searches page 100 records at a time and stop here.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 300, "type": "integer", "description": "Pacing for calls to www.quorum.us/api.", "default": 60 }, "username": { "title": "Quorum username", "type": "string", "description": "The Quorum username of the user your API key was issued to. Sent only to www.quorum.us in the Authorization header; never logged. You can instead set the DATA_API_USERNAME secret, or give the key as username:key." }, "apiKey": { "title": "API key", "type": "string", "description": "Your own Quorum API key, issued by your Customer Success Manager once your organization has the API add-on. Stored as a secret and sent only to www.quorum.us as Authorization: ApiKey username:key; never logged. You can instead set the DATA_API_KEY secret." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }