GET /v1/schedules/schedule_b/
Schedule B filings describe itemized disbursements. This data explains how committees and other filers spend their money. These figures are reported as part of forms F3, F3X and F3P.
The data are divided in two-year periods, called two_year_transaction_period, which is derived from the report_year submitted of the corresponding form. If no value is supplied, the results will default to the most recent two-year period that is named after the ending, even-numbered year.
Due to the large quantity of Schedule B filings, this endpoint is not paginated by page number. Instead, you can request the next page of results by adding the values in the last_indexes object from pagination to the URL of your last request. For example, when sorting by disbursement_date, you might receive a page of results with the following pagination information:
pagination: {
pages: 965191,
per_page: 20,
count: 19303814,
is_count_exact: False,
last_indexes: {
last_index: "230906248",
last_disbursement_date: "2014-07-04"
}
}
To fetch the next page of sorted results, append last_index=230906248 and last_disbursement_date=2014-07-04 to the URL. We strongly advise paging through these results by using the sort indices (defaults to sort by disbursement date, e.g. last_disbursement_date), otherwise some resources may be unintentionally filtered out. This resource uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset.
Note: because the Schedule B data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.
Request
- Base URLhttps://api.open.fec.gov (the document declares no server; this is the origin it was published from)
- AuthAPI key in header X-Api-Key and API key in query parameter api_key and API key in query parameter api_key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
An unique identifier for each page where the electronic or paper filing is reported.
Minium image number of the page where the schedule item is reported
Maxium image number of the page where the schedule item is reported
Filter for all amounts greater than a value.
Filter for all amounts less than a value.
The earliest date used to filter reported activity. Only records with an applicable reporting date after this date are returned.
The latest date used to filter reported activity. Only records with an applicable reporting date before this date are returned.
A unique identifier assigned to each committee or filer registered with the FEC. In general a committee id begins with the letter C which is followed by eight digits.
Description of disbursement
Disbursement purpose category
When sorting by disbursement_amount, this is populated with the disbursement_amount of the last result. However, you will need to pass the index of that last result to last_index to get the next page.
When sorting by disbursement_date, this is populated with the disbursement_date of the last result. However, you will need to pass the index of that last result to last_index to get the next page.
Filter for form and line number using the following format: FORM-LINENUMBER. For example an argument such as F3X-16 would filter down to all entries from form F3X line number 16.
City of recipient
The FEC identifier should be represented here if the contributor is registered with the FEC.
Name of the entity receiving the disbursement
State of recipient. A valid two-letter U.S. state or territory code. Use ZZ for foreign countries, or other for foreign countries and any invalid or missing values.
The one-letter designation code of the organization: - A authorized by a candidate - J joint fundraising committee - P principal campaign committee of a candidate - U unauthorized - B lobbyist/registrant PAC - D leadership PAC
The one-letter code for the kind for organization: - C corporation - L labor organization - M membership organization - T trade association - V cooperative - W corporation without capital stock - H host committee - I inaugural committee
The one-letter type code of the organization: - C communication cost - D delegate - E electioneering communication - H house - I independent expenditure filer (not a committee) - N PAC - nonqualified - O independent expenditure-only (super PACs) - P presidential - Q PAC - qualified - S senate - U single candidate independent expenditure - V PAC with non-contribution account, nonqualified - W PAC with non-contribution account, qualified - X party, nonqualified - Y party, qualified - Z national party non-federal account
This is a two-year period that is derived from the year a transaction took place in the Itemized Schedule A and Schedule B tables. In cases where we have the date of the transaction (contribution_receipt_date in schedules/schedule_a, disbursement_date in schedules/schedule_b) the two_year_transaction_period is named after the ending, even-numbered year. If we do not have the date of the transaction, we fall back to using the report year (report_year in both tables) instead, making the same cycle adjustment as necessary. If no transaction year is specified, the results default to the most current cycle.
The number of results returned per page. Defaults to 20.
Index of last result from previous page
Provide a field to sort by. Use - for descending order.
Hide null values on sorted column(s).
Toggle that filters out all rows having sort column that is non-null
API key for https://api.data.gov. Get one at https://api.data.gov/signup.
Response
Default response
Changes
No recorded changes to this operation across all 20 revisions of this API.