Search Methods
Common Parameters
Unless otherwise specified, all search methods respond to
page
and per_page
parameters.
Additionally, most results are available in JSON, CSV, or XLS formats, via changing the extension of the request file.
Bulk Data
The datasets behind each of these search methods—as well as several additional datasets—are available in bulk. See the Bulk Data page for more information.
Methods
Campaign Contributions
Search for itemized campaign contributions at the federal (FEC) or state (NIMSP) level.
/contributions.:format
Parameters
Name | Type | Description |
---|---|---|
amount |
comparison |
The amount of the contribution in US dollars. |
contributor_ft |
string |
Full-text search on the name of the contributing individual, PAC, organization or employer. |
contributor_state |
inclusion |
The two-letter state abbreviation from which the contribution was made, eg. DC. |
cycle |
inclusion |
The year (YYYY) of the election cycle. |
date |
comparison |
Date or date range of the contribution in ISO format. |
for_against |
string |
When organizations run ads against a candidate, they are counted as independent expenditures with the opposed candidate as the recipient. This parameter can be used to filter contributors meant for the candidate from those meant to be against the candidate. |
organization_ft |
string |
Full-text search on the name of the contributing employer, organization or parent organization. |
recipient_ft |
string |
Full-text search on the name of the PAC or candidate receiving the contribution. |
recipient_state |
inclusion |
The two-letter state abbreviation of the state in which the candidate receiving the contribution is running, eg. VA. |
seat |
inclusion |
The type of office being sought. Possible values include:
|
seat_status |
string |
I for incumbent, O for open. The
value will be filled in where available in the source data.
|
seat_result |
string |
W for win, L for loss. The value
will be filled in where available in the source data.
|
Example
Get all DC contributions over $1000 in the 2012 election cycle:
http://transparencydata.com/api/1.0/contributions.json?amount=%3E%7C1000&contributor_state=DC&cycle=2012&apikey=YOUR_KEY
Response
See the schema documentation for descriptions of the response fields.
[
{
"seat": "federal:president",
"committee_ext_id": "C00431445",
"seat_held": "federal:president",
"recipient_party": "D",
"transaction_type_description": "Transfer In Affiliated",
"recipient_type": "P",
"seat_status": "I",
"recipient_state": "",
"contributor_category": "Z4200",
"contributor_gender": "",
"contributor_state": "DC",
"recipient_category": "Z1200",
"is_amendment": true,
"district": "",
"organization_name": "Obama Victory Fund",
"recipient_ext_id": "N00009638",
"parent_organization_name": "",
"contributor_address": "",
"transaction_id": "pac2pac:2012:4013020121150134096",
"contributor_occupation": "",
"filing_id": "12950025570",
"contributor_city": "WASHINGTON",
"recipient_state_held": "",
"district_held": "",
"recipient_name": "Barack Obama (D)",
"organization_ext_id": "C00494740",
"contributor_zipcode": "20003",
"transaction_namespace": "urn:fec:transaction",
"date": "2011-06-30",
"committee_name": "Obama for America",
"candidacy_status": false,
"parent_organization_ext_id": "",
"cycle": 2012,
"contributor_name": "Obama Victory Fund",
"contributor_type": "C",
"contributor_employer": "",
"seat_result": "W",
"transaction_type": "18g",
"amount": "12750000.00",
"contributor_ext_id": "C00494740",
"committee_party": "D"
},
...snip...
]
Bundled Campaign Contributions
Search for itemized bundlers.
/contributions/bundled.:format
Parameters
Name | Type | Description |
---|---|---|
lobbyist_name |
string |
The name of the lobbyist bundling on behalf of the recipient. |
recipient_name |
string |
The name of the politician or committee which received the bundled contribution. |
Example
Get campaign contributions bundled by Patton Boggs.
transparencydata.com/api/1.0/contributions/bundled.json?page=1&per_page=20&lobbyist_name=Patton%20Boggs&apikey=YOUR_KEY
Response
[
{
"bundler_occupation": null,
"bundler_name": "SU, PIPER NIETERS",
"report_type": "QYS",
"semi_annual_amount": 19000,
"standardized_firm_name": "Patton Boggs LLP",
"state": "DC",
"street_addr2": null,
"street_addr1": "2550 M STREET NW",
"zip_code": "20037",
"end_date": "2009-12-31",
"city": "WASHINGTON",
"committee_name": "BENNET FOR COLORADO",
"committee_fec_id": "C00458398",
"standardized_lobbyist_name": "Su, Piper",
"report_year": 2009,
"pdf_url": "http://query.nictusa.com/pdf/707/10020063707/10020063707.pdf",
"standardized_recipient_name": "Michael F Bennet (D)",
"start_date": "2009-10-01",
"bundler_employer": "PATTON BOGSS",
"bundler_fec_id": null,
"file_num": -248701,
"period_amount": 19000
},
{
"bundler_occupation": null,
"bundler_name": "JONAS, JOHN",
"report_type": "Q2S",
"semi_annual_amount": 32000,
"standardized_firm_name": "Patton Boggs LLP",
"state": "VA",
"street_addr2": null,
"street_addr1": "5840 COLFAX AVE",
"zip_code": "22311",
"end_date": "2010-06-30",
"city": "ALEXANDRIA",
"committee_name": "EARL POMEROY FOR CONGRESS",
"committee_fec_id": "C00266619",
"standardized_lobbyist_name": "Jonas, John",
"report_year": 2010,
"pdf_url": "http://query.nictusa.com/pdf/844/10930945844/10930945844.pdf",
"standardized_recipient_name": "Earl Pomeroy (D)",
"start_date": "2010-01-01",
"bundler_employer": "PATTON BOGGS, LLP",
"bundler_fec_id": null,
"file_num": 479579,
"period_amount": 32000
},
{
"bundler_occupation": "LEGISLATIVE COUNCIL",
"bundler_name": "COWAN, MARK D MR",
"report_type": "Q2S",
"semi_annual_amount": 114500,
"standardized_firm_name": "Patton Boggs LLP",
"state": "VA",
"street_addr2": null,
"street_addr1": "1123 LITTON LANE",
"zip_code": "22101",
"end_date": "2012-06-30",
"city": "MCLEAN",
"committee_name": "REPUBLICAN NATIONAL COMMITTEE",
"committee_fec_id": "C00003418",
"standardized_lobbyist_name": "Cowan, Mark D",
"report_year": 2012,
"pdf_url": "http://query.nictusa.com/pdf/333/12952442333/12952442333.pdf",
"standardized_recipient_name": "Republican National Cmte",
"start_date": "2012-04-01",
"bundler_employer": "PATTON BOGGS LLP",
"bundler_fec_id": null,
"file_num": 797251,
"period_amount": 0
}
]
Contractor Misconduct
Search for itemized misconduct incident reports
/misconduct.:format
Parameters
Name | Type | Description |
---|---|---|
contractor |
string |
The name of the contractor to search for. |
contracting_party |
string |
The FIPS code for the contracting agency. |
date_year |
inclusion |
The year in which a date significant to the incident occurred. |
enforcement_agency |
string |
The name of the agency responsible for the enforcement action. |
instance |
string |
Full-text search on the description of the misconduct instance. |
penalty_amount |
comparison |
The amount of the penalty, in US dollars. |
Example
Get misconduct instances for SAIC in 2012:
transparencydata.com/api/1.0/misconduct.json?page=1&per_page=20&contractor=SAIC&date_year=2012&apikey=YOUR_KEY
Response
[
{
"disposition": "Deferred Prosecution Agreement",
"penalty_amount": 500392977,
"date_year": 2012,
"date_significance": "Date of Settlement Announcement",
"enforcement_agency": "Justice",
"contractor": "SAIC",
"instance": "CityTime Contract Fraud Settlement",
"synopsis": "In March 2012, SAIC agreed to pay $500.4 million under a deferred prosecution agreement to resolve claims of fraud occurring on the CityTime information technology contract with New York City. SAIC admitted it failed to investigate and notify the city of claims that project manager Gerard Denault steered work to subcontractor Technodyne LLC in exchange for kickbacks. SAIC agreed to the filing of one count of conspiracy to commit wire fraud and agreed to disgorge proceeds\nof the offense, including $370.4 million in restitution to the city and a $130 million penalty. The charge will be dropped after 3 years if SAIC pays the money and cooperates with federal investigators. See related SAIC instances \"U.S. v. Denault (CityTime Contract Fraud)\" and \"U.S. v. Bell (CityTime Contract Fraud).",
"url": "http://www.contractormisconduct.org/index.cfm/1,73,222,html?CaseID=1648",
"contracting_party": "State/Local",
"date": "2012-03-14",
"misconduct_type": "Government Contract Fraud",
"court_type": "Criminal"
}
]
Earmarks
Search itemized earmark requests through FY 2010.
/earmarks.:format
Parameters
Name | Type | Description |
---|---|---|
amount |
comparison |
The final amount of the earmark. |
bill |
string |
The bill, section or subsection of the earmark. |
city |
string |
The city where the money will be spent. |
description |
string |
Full-text search on the description of the earmark request. |
member |
string |
Full-text search on the member of Congress requesting the earmark. |
member_party |
inclusion |
The party of the member requesting the earmark, D, R or I. |
member_state |
inclusion |
The 2-letter state abbreviation of the requesting member. |
recipient |
string |
Full-text search on the intended recipient, when known. |
year |
inclusion |
The YYYY-formatted fiscal year for which the earmark was requested. |
Example
Get the biggest earmark for Alaska in FY 2010:
transparencydata.com/api/1.0/earmarks.json?page=1&per_page=20&member_state=AK&year=2010&apikey=YOUR_KEY
Response
See the schema documentation for descriptions of the response fields.
[
{
"description": "Aviation Task Force Complex, Ph 1, Incr 1",
"recipients": "",
"notes": "",
"bill": "Military Construction",
"undisclosed": "",
"locations": "Fort Wainwright, AK",
"fiscal_year": 2010,
"omni_amount": "0.00",
"house_amount": "95000000.00",
"senate_amount": "125000000.00",
"bill_subsection": "",
"members": "Sen. Lisa Murkowski (R-AK)",
"bill_section": "Army",
"final_amount": "95000000.00",
"presidential": "m",
"budget_amount": "0.00"
}
]
EPA ECHO
Search itemized EPA enforcement actions.
/epa.:format
Parameters
Name | Type | Description |
---|---|---|
case_name |
string |
The name of the enforcement case. |
case_num |
inclusion |
One or more specific case numbers. |
defendants |
string |
Full-text search for the name(s) of the defendant companies. |
first_date |
string |
Start of a date range of the most recent date of significance to the case in ISO format. |
last_date |
string |
End of a date range of the most recent date of significance to the case in ISO format. |
location_adresses |
string |
Full-text search on all addresses associated with the case. |
penalty |
comparison |
Total penalties, in US dollars. |
Example
Get enforcement actions against Massey Energy since 2005
transparencydata.com/api/1.0/epa.json?page=1&per_page=20&defendants=Massey%20Energy&first_date=%3E%7C2005-01-01&apikey=YOUR_KEY
Response
See the schema documentation for descriptions of the response fields.
[
{
"penalty_enfotpa": 13300000,
"penalty_enfccaa": "7100000",
"penalty_enfcslp": 0,
"first_date": "2005-07-25",
"num_defendants": 5,
"case_name": "MASSEY ENERGY COMPANY, ET. AL.(NATIONAL CASE)(LEAD)",
"penalty": "20400000",
"last_date": "2008-04-09",
"penalty_enfops": 0,
"first_date_significance": "DOJ",
"penalty_enfotsa": 0,
"location_addresses": "2 JERRY FORK ROAD, DRENNEN, WV 26667; 4 NORTH 4TH ST, RICHMOND, VA 23219-0000; HUTCHINSON BRANCH ROAD, SUMMERSVILLE, WV 26651; ROUTE 3, SYLVESTER, WV 25193",
"penalty_enfcraa": 0,
"last_date_significance": "FOE",
"defendants": "ALEX ENERGY, ELK RUN COAL COMPANY, MASSEY ENERGY COMPANY, PEERLESS EAGLE COAL COMPANY, POWER MOUNTAIN COAL COMPANY",
"case_num": "03-2005-0380"
},
{
"penalty_enfotpa": 6700000,
"penalty_enfccaa": "3300000",
"penalty_enfcslp": 0,
"first_date": "2006-09-28",
"num_defendants": 28,
"case_name": "MASSEY ENERGY CO. & SUBSIDIARIES (NATIONAL CASE)",
"penalty": "10000000",
"last_date": "2011-03-22",
"penalty_enfops": 0,
"first_date_significance": "DOJ",
"penalty_enfotsa": 0,
"location_addresses": "115 NORTH BIG CREEK RD, SIDNEY, KY 41564; 185 MIDDLE FORK WOLF CRK RD, INEZ, KY 41224; 194/BRUSHY CREEK RD, MOREE, KY 41250; 3185 MIDDLE FORK CRK RD, INEZ, KY 41224; 3185 MIDDLE FORK WOLF CRK RD, INEZ, KY 41224; 3185 MIDDLE FRK WOLF CRK RD, INEZ, KY 41224; 5263 STATE HWY 194 E, KIMPER, KY 41539; BENT BR RD, HATFIELD, KY 41514; CASSADY BRAND RD / KY 908, PREECE, KY 41224; DAVELLA RD & KY RT 3, DAVELLA, KY 41214; EMILY CRK & LONG BR RD, PILGRAM, KY 41250; FRALEY BRANCH RD / KY 468, SIDNEY, KY 41564; HWY 468, SIDNEY, KY 41564; KY 1434 & ALDRIDGE BRANCH RD, MOREE, KY 41250; KY 1439 & WHITE CABIN BR RD, MOREE, KY 41250; KY 1439 & WOLF CREEK RD, PREECE, KY 41224; KY 1714, PILGRIM, KY 41250; KY 194 & CR 6272, PHYLLIS, KY 41554; KY 292 & CULLER HOLLOW RD, AFLEX, KY 41529; KY 292 & KY 468, LOVELY, KY 41231; KY 292 & STRINGTOWN BR RD, RANSOM, KY 41558; KY 319 / KY 1056, MCCARR, KY 41544; KY 3419, RANSOM, KY 41558; KY 468 & COUNTY RT 7125, NOLAN WV, KY 00000; KY 468 & ELKINS FORK, VARNEY, KY 41571; KY 468 & HALFWAY BR RD, RURAL, KY 41514; KY 468 & LICK BR RD, HATFIELD, KY 41514; KY 468 & LONG BR RD, HATFIELD, KY 41514; KY 468 & ROCKHOUSE FORK RD, SIDNEY, KY 41564; KY 468 & SWINGE CAMP BR, RURAL, KY 41514; KY 612 & KY 468, TURKEY CREEK, KY 41570; KY 908 JCT & LYNN BARK FORK RD, PREECE, KY 41224; KY 908 / WALNUT FORK RD, MOREE, KY 41224; KY HWY 119, SIDNEY, KY 41564; KY RT 1439 & WOLF CREEK RD, PILGRIM, KY 41250; LONG FORK RD, SOUTH WILLIAMSON, KY 41503; MCGEE BR RD, MOREE, KY 41250; NOSBEN BRANCH RD & KY RT 612, RURAL, KY 25687; PEGS BRANCH RD WITH US 119, BELFRY, KY 41514; PIGEONROOST FORK / KY 1714, LAURA, KY 41250; PIGEONROOST FORK & KY 1714, SIDNEY, KY 41564; RIGHT FORK RD & PANTHER FORK RD, DAVELLA, KY 41214; ROCKHOUSE FORK RD WITH KY 468, HATFIELD, KY 41514; ROCKHOUSE FORK RD W/ KY 468, HATFIELD, KY 41514; ROCKHOUSE FORK W/ KY 468, SIDNEY, KY 41564; SANDLICK BRANCH RD & KY 3, INEZ, KY 41224; ST RT 1439 & ASHLOG BRANCH RD, MCCLURE, KY 41250; ST RT 1714 INTER EMILY CREEK, UNKNOWN, KY 00000; ST RTS 319 & 1056, RANSOM, KY 41531; UNKNOWN, UNKNOWN, KY 00000; UPPER LICK BR & LONG FRK, TURKEY CREEK, KY 41570; US 119 & PEGS BR RD, BELFRY, KY 41514; US 119 & ROAD FORK RD, SIDNEY, KY 41564; US 119 W & KY 468, SIDNEY, KY 41654; VENTERS BRANCH RD, DAVELLA, KY 41214; WALKER BRANCH RD JCT KY RT 194, GULNARE, KY 41501; WOLF CREEK & MAYNARD FORK RD, THOMAS, KY 41626",
"penalty_enfcraa": 0,
"last_date_significance": "SNDDL",
"defendants": "ALEX ENERGY, INC., ARACOMA COAL COMPANY, INC., A.T. MASSEY COAL COMPANY, BANDMILL COAL CORPORATION, BIG BEAR MINING COMPANY, CLEAR FORK COAL COMPANY, DELBARTON MINING COMPANY, DUCHESS COAL COMPANY, ELK RUN COAL COMPANY, INC., GREEN VALLEY COAL COMPANY, INDEPENDENCE COAL COMPANY, INC., JACKS BRANCH COAL COMPANY, LONG FORK COAL COMPANY, MAJESTIC MINING, INC., MARFORK COAL COMPANY, INC., MARTIN COUNTY COAL CORPORATION, MASSEY COAL SERVICES, INC., MASSEY ENERGY COMPANY, NEW RIDGE MINING COMPANY, OMAR MINING COMPANY, PEERLESS EAGLE COAL COMPANY, PERFORMANCE COAL COMPANY, POWER MOUNTAIN COAL COMPANY, RAWL SALES & PROCESSING CO., ROAD FORK DEVELOPMENT COMPANY, INC., SIDNEY COAL COMPANY, INC., STIRRAT COAL COMPANY, TRACE CREEK COAL COMPANY",
"case_num": "04-2006-9037"
}
]
FACA Memberships
Search for itemized Federal Advisory Committee memberships.
/faca.:format
Parameters
Name | Type | Description |
---|---|---|
affiliation |
string |
The name of the affiliated organization. |
agency_name |
string |
The name of the agency associated with the committee. |
committee_name |
string |
The name of the advisory committee. |
member_name |
string |
Full-text search on the name of the affiliated organization. |
year |
inclusion |
The YYYY-formatted year(s) the member sat on the committee. |
Example
Get committees Francis Collins sat on in 2012:
transparencydata.com/api/1.0/faca.json?page=1&per_page=20&member_name=Francis%20Collins&year=2012&apikey=YOUR_KEY
Response
[
{
"committee_url": "http://www.nih.gov/about/director/acd.htm",
"member_firstlast": "FRANCIS COLLINS",
"agency_abbr": "HHS",
"end_date": "2013-12-31",
"pay_plan": "Hourly or Daily Compensation plus Travel and Per Diem",
"represented_group": "",
"appointment_term": "No Fixed Term",
"member_designation": "Regular Government Employee (RGE)",
"org_id": null,
"appointment_type": "Agency",
"affiliation": "DIRECTOR",
"agency_name": "Department of Health and Human Services",
"member_name": "FRANCIS S COLLINS",
"pay_source": "Executive Branch",
"committee_name": "Advisory Committee to the Director, National Institutes of Health",
"chair": true,
"org_name": null,
"start_date": "2009-08-17"
},
{
"committee_url": "http://acd.od.nih.gov/",
"member_firstlast": "FRANCIS COLLINS",
"agency_abbr": "HHS",
"end_date": "2012-12-31",
"pay_plan": "Hourly or Daily Compensation plus Travel and Per Diem",
"represented_group": "",
"appointment_term": "4 years",
"member_designation": "Regular Government Employee (RGE)",
"org_id": null,
"appointment_type": "Agency",
"affiliation": "DIRECTOR",
"agency_name": "Department of Health and Human Services",
"member_name": "FRANCIS S COLLINS",
"pay_source": "Executive Branch",
"committee_name": "Advisory Committee to the Director, National Institutes of Health",
"chair": true,
"org_name": null,
"start_date": "2009-08-16"
},
{
"committee_url": "http://www.nih.gov/about/director/acd.htm",
"member_firstlast": "FRANCIS COLLINS",
"agency_abbr": "HHS",
"end_date": "2012-12-31",
"pay_plan": "Hourly or Daily Compensation plus Travel and Per Diem",
"represented_group": "",
"appointment_term": "4 years",
"member_designation": "Regular Government Employee (RGE)",
"org_id": null,
"appointment_type": "Agency",
"affiliation": "DIRECTOR",
"agency_name": "Department of Health and Human Services",
"member_name": "FRANCIS S COLLINS",
"pay_source": "Executive Branch",
"committee_name": "Advisory Committee to the Director, National Institutes of Health",
"chair": true,
"org_name": null,
"start_date": "2009-08-16"
},
...snip...
]
Federal Contracts
Search for itemized federal contract awards.
/contracts.:format
Parameters
Name | Type | Description |
---|---|---|
agency_id |
inclusion |
The FIPS code for the agency, eg. 51013. (More on FIPS) |
contracting_agency_id |
inclusion |
The FIPS code for the contracting agency. |
current_amount |
comparison |
Current value of the contract in US dollars. |
fiscal_year |
inclusion |
A YYYY-formatted year in which the grant was awarded, 2006 up to the most recent fiscal year. |
maximum_amount |
comparison |
Maximum possible value of the contract in US dollars. |
obligated_amount |
comparison |
The amount obligated or de-obligated by the transaction in US dollars. |
place_district |
inclusion |
The contressional district in which the contract action will be performed, eg. 7. |
place_state |
inclusion |
The FIPS code for the state in which the contract action be performed, eg. 50. |
requesting_agency_id |
inclusion |
The FIPS code for the requesting agency. |
signed_date |
comparison |
The date of contract signature in ISO format. |
vendor_city |
string |
Full-text search on the name of the primary city in which the contractor does business. |
vendor_district |
inclusion |
The primary congressional district in which the contractor does business. |
vendor_duns |
inclusion |
The Dun & Bradstreet number assigned to the corporate parent of the contractor. |
vendor_name |
string |
Full-text search on the name of the contractor. |
vendor_parent_duns |
inclusion |
The Dun & Bradstreet nuber assigned to the corporate parent of the contractor. |
vendor_state |
inclusion |
The primary state in which the contractor does business, eg. NY. |
vendor_zipcode |
inclusion |
The primary zipcode in which the contractor does business, eg. 20036. |
Example
Get the largest contract awarded to L-3 Communications in FY 2012:
http://transparencydata.com/api/1.0/contracts.json?per_page=1&fiscal_year=2012&vendor_duns=618019632&apikey=YOUR_KEY
Response
See the schema documentation for descriptions of the response fields.
[
{
"contractingofficeid": "W911QY",
"srdvobflag": false,
"reasonnotcompeted": "",
"seatransportation": "U",
"hubzoneflag": false,
"contractbundling": "D",
"hbcuflag": false,
"annualrevenue": "12000000000.00",
"majorprogramcode": "",
"firm8aflag": false,
"smallbusinesscompetitivenessdemonstrationprogram": null,
"tribalgovernmentflag": false,
"apaobflag": false,
"emergingsmallbusinessflag": false,
"naobflag": false,
"idvpiid": "W911QY10D0057",
"locationcode": "",
"isserviceprovider": null,
"extentcompeted": "A",
"hospitalflag": false,
"effectivedate": "2012-03-23",
"reasonformodification": "",
"agency_name": "",
"receivesgrants": "Y",
"purchasecardaspaymentmethod": false,
"numberofactions": 1,
"phoneno": "8563383645",
"idvmodificationnumber": "0",
"localareasetaside": "N",
"agencyid": "9700",
"countryoforigin": "USA",
"educationalinstitutionflag": false,
"contractactiontype": "DO",
"multiyearcontract": false,
"saaobflag": false,
"consolidatedcontract": false,
"subcontractplan": "",
"manufacturingorganizationtype": "A",
"federalgovernmentflag": false,
"rec_flag": null,
"typeofsetaside": "NONE",
"fundingrequestingofficeid": "W81XAG",
"competitiveprocedures": "",
"streetaddress": "1 FEDERAL ST",
"costaccountingstandardsclause": "",
"transaction_status": "active",
"mod_agency": "2100",
"nonprofitorganizationflag": false,
"vendorenabled": "",
"ultimatecompletiondate": "2013-05-31",
"vendorlegalorganizationname": "L-3 COMMUNICATIONS CORPORATION",
"gfe_gfp": true,
"programacronym": "",
"research": "",
"state": "NJ",
"statutoryexceptiontofairopportunity": "",
"recoveredmaterialclauses": "C",
"contingencyhumanitarianpeacekeepingoperation": "X",
"haobflag": false,
"descriptionofcontractrequirement": "DELIVERY ORDER 0003 OF THE BATTLEFIELD ANTI-INTRUSION SYSTEM (BAIS)",
"receivescontracts": "Y",
"vendorlocationdisableflag": null,
"vendoralternatesitecode": "081031004",
"maj_fund_agency_cat": "97",
"placeofperformancezipcode": "081031004",
"obligatedamount": "18099998.00",
"davisbaconact": false,
"parentdunsnumber": "008898843",
"costorpricingdata": "N",
"multipleorsingleawardidc": "",
"minorityinstitutionflag": false,
"contractfinancing": "F",
"principalnaicscode": "334220",
"fundingrequestingagencyid": "2100",
"lastdatetoorder": "",
"stategovernmentflag": false,
"claimantprogramcode": "A7",
"walshhealyact": true,
"commercialitemtestprogram": false,
"mod_parent": "L-3 COMMUNICATIONS HOLDINGS INC.",
"baseandalloptionsvalue": "18099998.00",
"placeofmanufacture": "D",
"fiscal_year": 2012,
"vendoralternatename": "COMMUNICATION SYSTEMS - EAST DIVISION",
"minorityownedbusinessflag": false,
"priceevaluationpercentdifference": "",
"city": "CAMDEN",
"numberofoffersreceived": 3,
"commercialitemacquisitionprocedures": "D",
"veteranownedflag": false,
"evaluatedpreference": "NONE",
"informationtechnologycommercialitemcategory": "",
"useofepadesignatedproducts": "A",
"aiobflag": "N",
"maj_agency_cat": "97",
"psc_cat": "58",
"transactionnumber": "0",
"pop_cd": "NJ01",
"baseandexercisedoptionsvalue": "18099998.00",
"modnumber": "0",
"idvagencyid": "9700",
"organizationaltype": "CORPORATE NOT TAX EXEMPT",
"statecode": "NJ",
"solicitationprocedures": "NP",
"congressionaldistrict": "NJ01",
"vendorname": "L-3 COMMUNICATIONS CORPORATION",
"productorservicecode": "5820",
"receivescontractsandgrants": "Y",
"currentcompletiondate": "2013-05-31",
"performancebasedservicecontract": "X",
"piid": "0003",
"progsourcesubacct": "",
"divisionname": "",
"baobflag": false,
"contracting_agency_name": "",
"womenownedflag": false,
"vendor_state_code": "NJ",
"fedbizopps": "Y",
"vendordoingasbusinessname": "",
"ccrexception": "",
"divisionnumberorofficecode": "",
"unique_transaction_id": "f9454cb7766cc69b0a48e3655e58c87d",
"localgovernmentflag": false,
"servicecontractact": false,
"systemequipmentcode": "000",
"solicitationid": "W911QY10R0031",
"sdbflag": false,
"id": 1138460,
"streetaddress3": "",
"progsourceaccount": "2035",
"zipcode": "081031004",
"progsourceagency": "21",
"interagencycontractingauthority": "X",
"contractingofficeagencyid": "2100",
"account_title": "",
"vendorsitecode": "618019632",
"numberofemployees": 64000,
"streetaddress2": "",
"vendorcountrycode": "UNITED STATES",
"fundedbyforeignentity": "",
"otherstatutoryauthority": "",
"dunsnumber": "618019632",
"placeofperformancecongressionaldistrict": "NJ01",
"placeofperformancecountrycode": "US",
"vendor_cd": "NJ01",
"lettercontract": "X",
"registrationdate": "2002-04-09",
"shelteredworkshopflag": false,
"contractingofficerbusinesssizedetermination": "O",
"pop_state_code": "NJ",
"typeofcontractpricing": "J",
"faxno": "8563382741",
"signeddate": "2012-03-23",
"nationalinterestactioncode": "NONE",
"a76action": false,
"typeofidc": "",
"renewaldate": "2011-03-08",
"clingercohenact": false,
"requesting_agency_name": ""
}
]
Federal Grants
Search for itemized federal grants.
/grants.:format
Parameters
Name | Type | Description |
---|---|---|
agency_ft |
string |
Full-text search on the reported name of the federal agency awarding the grant. |
amount_total |
comparison |
Total amount of the grant in US dollars. |
assistance_type |
inclusion |
A general code for the type of grant awarded. Possible values include:
|
fiscal_year |
inclusion |
The YYYY-formatted year in which the grant was awarded, from 2000 up to the most recent fiscal year. |
recipient_ft |
string |
Full-text search on the reported name of the grant recipient. |
recipient_state |
inclusion |
Two-letter postal abbreviation of the state in which the grant was awarded, eg. MD. |
recipient_type |
inclusion |
A general code for the type of entity that recieved the grant.
possible values include:
|
Example
Get the top grant given by USAID in FY 2012:
http://transparencydata.com/api/1.0/grants.json?agency_ft=Agency%20For%20International%20Development&fiscal_year=2012&per_page=1&apikey=YOUR_KEY
Response
See the schema documentation for descriptions of the response fields.
[
{
"progsrc_acnt_code": "1031",
"principal_place_state": "00",
"non_fed_funding_amount": "0.0",
"rec_flag": null,
"recipient_zip": "204330001",
"fiscal_year": 2012,
"progsrc_subacnt_code": "",
"record_type": "2",
"cfda_program_num": "98.001",
"ending_date": "2013-09-30",
"recipient_type": "25",
"transaction_status": "active",
"principal_place_cc": "FORGN",
"face_loan_guran": "0",
"principal_place_cd": "",
"total_funding_amount": "1018158867",
"orig_sub_guran": "0",
"principal_place_code": "00FORGN",
"agency_code": "7200",
"recipient_county_code": "110",
"assistance_type": "04",
"uri": "AID-GHH-G-00-02-00002-17",
"recipient_country_code": "USA",
"maj_agency_cat": "72",
"id": 6752773,
"starting_date": "2002-06-04",
"duns_conf_code": "0",
"account_title": "Global Health and Child Survival",
"project_description": "936-3110",
"recipient_city_code": "50000",
"duns_no": "062024112NONE",
"recipient_county_name": "District of Columbia",
"cfda_program_title": "USAID Foreign Assistance for Programs Overseas",
"recip_cat_type": "o",
"sai_number": "SAI NOT AVAILABLE",
"obligation_action_date": "2012-06-22",
"fyq": "",
"progsrc_agen_code": "19",
"federal_award_mod": "0017",
"principal_place_state_code": "",
"recipient_name": "WORLD BANK OFFICE OF THE PUBLISHER",
"receip_addr2": "",
"receip_addr3": "",
"receip_addr1": "1818 H ST NW",
"recipient_cd": "",
"recipient_city_name": "WASHINGTON",
"federal_award_id": "AIDGHHG000200002",
"fed_funding_amount": "1018158867",
"recipient_state_code": "DC",
"unique_transaction_id": "be98113966b2de11d48108fc54a31f04",
"agency_name": "AGENCY FOR INTERNATIONAL DEVELOPMENT",
"principal_place_zip": "",
"fyq_correction": "",
"action_type": "B",
"correction_late_ind": "",
"asst_cat_type": "g"
}
]
Federal Lobbying
Search itemized federal lobbying reports.
/lobbying.:format
Parameters
Name | Type | Description |
---|---|---|
amount |
comparison |
The amount spent on lobbying in US dollars. |
client_ft |
string |
Full-text search on the name of the client for which the lobbyist is working. |
client_parent_ft |
string |
Full-text search on the name of the parent organization of the client. |
filing_type |
inclusion |
The type of filing as identified by CRP. CRP recommends
you observe the following rules:
|
lobbyist_ft |
string |
Full-text search on the name of the lobbyist involved in the lobbying activity. |
registrant_ft |
string |
Full-text search on the name of the person or organization
filing the lobbyist registration. This is typically the
firm that employs the lobbyists. Use the registrant_is_firm
field in the response object to filter on firms vs. individuals. |
transaction_id |
inclusion |
Report ID given by the Senate Office of Public Records |
transaction_type |
inclusion |
The type of filing as reported by the Senate Office of Public Records. A current CSV of allowed values can be found here: transaction_types-20130207.csv. |
year |
inclusion |
The year in which the registration was filed. A YYYY formatted year, 1998 to the most recent election year. |
Example
Get the top registration, dollarwise, in 2012 by Patton Boggs:
transparencydata.com/api/1.0/lobbying.json?per_page=1®istrant_ft=Patton%20Boggs&year=2012&apikey=YOUR_KEY
Response
See the schema documentation for descriptions of the response fields.
[
{
"registrant_name": "Patton Boggs LLP",
"filing_type": "n",
"client_category": "E1100",
"client_name": "Ivanishvili, Bidzina",
"agencies": [
{
"agency_name": "Dept of State",
"agency_ext_id": "039 "
},
{
"agency_name": "Dept of Treasury",
"agency_ext_id": "041 "
},
{
"agency_name": "Export-Import Bank of the US",
"agency_ext_id": "051 "
},
{
"agency_name": "Federal Reserve System",
"agency_ext_id": "062 "
},
{
"agency_name": "US House of Representatives",
"agency_ext_id": "002 "
},
{
"agency_name": "US Senate",
"agency_ext_id": "001 "
},
{
"agency_name": "White House",
"agency_ext_id": "012 "
}
],
"transaction_type": "q1a",
"client_parent_name": "Ivanishvili, Bidzina",
"amount": "510000.00",
"transaction_id": "B7025EBA-41B8-4FB4-AECB-75BD5E8306F3",
"lobbyists": [
{
"member_of_congress": false,
"candidate_ext_id": null,
"government_position": null,
"lobbyist_name": "Harris, Laurence",
"lobbyist_ext_id": "Y0000040336L"
},
{
"member_of_congress": false,
"candidate_ext_id": null,
"government_position": null,
"lobbyist_name": "Norman, W Caffrey",
"lobbyist_ext_id": "Y0000003857L"
},
{
"member_of_congress": false,
"candidate_ext_id": null,
"government_position": "Sen.E.Kennedy,Intern,99;SenateJuducCom,LawClrck,05",
"lobbyist_name": "Oresman, Matthew Scott",
"lobbyist_ext_id": "Y0000002649L"
},
{
"member_of_congress": false,
"candidate_ext_id": null,
"government_position": null,
"lobbyist_name": "Wisner, Graham",
"lobbyist_ext_id": "Y0000034763L"
}
],
"year": 2012,
"transaction_type_desc": "FIRST QUARTER AMENDMENT",
"registrant_is_firm": true,
"issues": [
{
"specific_issue": "Issues related to free and fair elections in Georgia",
"general_issue": "Foreign Relations",
"general_issue_code": "FOR"
},
{
"specific_issue": "Issues related to international banking.",
"general_issue": "Banking",
"general_issue_code": "BAN"
}
]
}
]