The Federal Contractor Lookup API tells you whether a company holds US federal contracts, how many dollars and from which agencies
Send a company name or a UEI and get the contract dollars it was awarded over the last three federal fiscal years, the number of awards and its top agencies and industries, read from the federal government's public spending database. 3 credits, charged only when the company has federal awards.
3
Credits per company
about $0.01 on Starter
0
Credits when no contract awards
no awards, no charge
Up to 5
Candidates listed for a vague name
free, then run it again with the UEI
3
Federal fiscal years in the total
FY2024 to FY2026, named in every answer
The database's registrations and award rows become one company and one set of totals
A search for a company returns many look-alike registrations, and the dollars sit in separate breakdowns. The lookup chooses the one that fits and adds the answer up for the fiscal years it names.
A company's federal contract record comes back as one flat payload
The record comes from the federal government's own public spending database
The contract dollars, award counts, agencies and industries come from the U.S. Treasury's record of what federal agencies award. It is public US government data, and every answer names the fiscal years it covers.
- Contract dollars over three completed fiscal years
- Number of contract awards
- Top five agencies with their dollars
- Top five industries with their dollars
The right registration is chosen for you
A large contractor is registered many times: a parent, its subsidiaries and look-alike names. The lookup folds the rows to one per UEI, takes the one that clearly fits, and tells you whether it is a parent, a child or a standalone record, with the parent named.
- level: parent, child or standalone
- parent_name and parent_uei for a child
- An exact name or UEI matched first
- A close match flagged for review
A name that fits several companies is listed for free
A partial name that fits more than one company is never silently matched to the wrong one. The answer says Several matches and lists up to five candidates with their UEIs, states and recent dollars, so you can run it again with the right UEI.
- Up to five candidates listed
- UEI, level, state and last-12-month dollars each
- Charged 0 credits
- Run it again with the UEI
The window is named in every answer
The total covers contract awards over the last three completed federal fiscal years, FY2024 to FY2026 today, with the start and end dates in the answer. Grants and loans are kept out of it, and the dollars of every kind of award in all years come back as a separate figure.
- window, window_start and window_end
- Contract awards only in the total
- all_awards_all_time_usd kept separate
- Loan face value returned apart
A company with no contract dollars is not charged
A company that is registered but holds no contract dollars in the window comes back found with a total of 0 and the recommendation VERIFY, and costs nothing. A name nobody holds, a vague name and a database that cannot answer cost nothing either.
- 0 credits when there are no contract dollars
- 0 credits when several companies fit
- 0 credits when nothing matches
- Bulk CSV with a company column
Small-business status and location come with the record
The same answer says whether the company is a small business, lists its business types in words, and gives its city, state, zip and country, so a lead list or a vendor file can be filtered without a second lookup.
- small_business true, false or null
- business_types in plain words
- City, state, zip and country
- The same fields in a CSV row
A company name or UEI goes in and the contract record comes out
Send a name or a UEI
POST a company name of 2 to 150 characters, or the 12-character UEI. A UEI wins when both are sent, and a malformed entry is refused with a clear error and costs nothing.
$ POST /api/v1/federal-contractor-lookup
"company": "Sample Aerospace Systems"
We find the one company and read its awards
We search the federal government's public spending database, choose the one registration that clearly fits, and total its contract awards over FY2024 to FY2026. If several companies fit, we list up to five and stop there.
Name or UEI matched
One registration chosen
Contract awards totalled
Agencies and industries ranked
Get the record, flat and structured
The dollars, award count, agencies and industries arrive in one JSON payload. A company with contract awards bills 3 credits, and every other answer bills nothing.
companySample Aerospace Systems Inc
contracts$1,284,500,000, 412 awards
top agencyDepartment of Defense
One endpoint looks up a contractor and works like every other 1Lookup call
Same authentication, same credit balance, and the same response envelope as every other 1Lookup product. If you have already integrated one endpoint, this one is a URL change.
curl -X POST https://app.1lookup.io/api/v1/federal-contractor-lookup \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "company": "Sample Aerospace Systems" }'{
"classification": {
"found": true,
"outcome": "found",
"outcome_label": "Found",
"name": "SAMPLE AEROSPACE SYSTEMS INC",
"uei": "SMPLE0000001",
"level": "parent",
"parent_name": null,
"parent_uei": null,
"small_business": false,
"state": "TX",
"window": "FY2024 to FY2026",
"total_obligated_usd": 1284500000,
"contract_count": 412,
"top_agency": "Department of Defense",
"top_agencies_list": [
"Department of Defense ($1.02 billion)",
"National Aeronautics and Space Administration ($196.30 million)",
"Department of Homeland Security ($48.10 million)"
],
"top_industry": "Aircraft Manufacturing",
"all_awards_all_time_usd": 3912000000,
"name_search": true,
"name_match": "exact"
},
"insights": {
"federal_contractor_result": {
"outcome": "found",
"name_match": "exact",
"other_matches": 0,
"recipient": {
"name": "SAMPLE AEROSPACE SYSTEMS INC",
"uei": "SMPLE0000001",
"level": "parent",
"business_types": ["Business", "Other than small business"],
"small_business": false,
"location": { "city": "FORT WORTH", "state": "TX", "zip": "76100", "country": "UNITED STATES" }
},
"awards": {
"window_label": "FY2024 to FY2026",
"window_start": "2023-10-01",
"window_end": "2026-09-30",
"total_obligated_usd": 1284500000,
"contract_count": 412,
"all_awards_last_12_months_usd": 436200000,
"all_awards_all_time_usd": 3912000000,
"loan_face_value_usd": 0
},
"top_agencies": [
{ "name": "Department of Defense", "amount_usd": 1020000000 },
{ "name": "National Aeronautics and Space Administration", "amount_usd": 196300000 }
],
"top_naics": [
{ "code": "336411", "description": "Aircraft Manufacturing", "amount_usd": 702400000 },
{ "code": "541330", "description": "Engineering Services", "amount_usd": 141200000 }
],
"breakdown_note": null,
"data_source": "usaspending"
}
},
"recommendations": {
"primary_action": "APPROVE",
"user_message": "SAMPLE AEROSPACE SYSTEMS INC holds federal contracts: $1.28 billion obligated across 412 contract awards in FY2024 to FY2026. Largest customer: Department of Defense."
},
"metadata": { "credits_used": 3, "cache_hit": false }
}A column of companies goes in and one row per company comes out
Upload a CSV with a company column that holds a name or a UEI and download a result file with each company's outcome, UEI, contract dollars and award count. The four companies here are invented.
- 1company
- 2sample aerospace systems
- 3northwind sample
- 4sample older awards llc
- 5harbor sample freight
| company | Outcome | Company | UEI | Contract Dollars (USD) | Contract Awards | Matches Found | Credits Used |
|---|---|---|---|---|---|---|---|
| sample aerospace systems | Found | SAMPLE AEROSPACE SYSTEMS INC | SMPLE0000001 | 1284500000 | 412 | 3 | |
| northwind sample | Several matches | 3 | 0 | ||||
| sample older awards llc | Found | SAMPLE OLDER AWARDS LLC | SMPLE0000002 | 0 | 0 | 0 | |
| harbor sample freight | Not found | 0 |
Ten more columns in the file, among them Level, Parent Company, Small Business, State, Window, Top Agency, Top Agencies, Top Industry and All Federal Awards, All Years (USD).
One row in, one row out
Every company becomes one row, so a list of 500 prospects is a spreadsheet of 500 rows you can sort by contract dollars or filter by agency.
A vague name is a free row
A name that fits several companies comes back as a row that says Several matches with a count, and costs 0 credits, so cleaning a list never bills for the guesses.
A company with no contract dollars is a free row
A company that is registered but holds no contract dollars in the window shows a total of 0 and costs 0 credits, so the list shows which entries have federal work and which do not.
One call returns a company's federal contract record
One call turns a company name or a UEI on a lead list, an application or a vendor form into the federal contract record behind it: whether the company holds contracts, how many dollars were awarded over the last three fiscal years, how many awards that is, which agencies paid it and in which industries, with the raw JSON your code receives beside it. The window is named in every answer.
- CompanySAMPLE AEROSPACE SYSTEMS INC
- UEISMPLE0000001
- RecordParent registration, TX
- WindowFY2024 to FY2026
- Contract dollars$1,284,500,000
- Contract awards412
- Largest agencyDepartment of Defense
- Top industryAircraft Manufacturing
- Small businessNo
- All awards, all years$3,912,000,000
- MatchExact name
{
"classification": {
"found": true,
"outcome": "found",
"name": "SAMPLE AEROSPACE SYSTEMS INC",
"uei": "SMPLE0000001",
"window": "FY2024 to FY2026",
"total_obligated_usd": 1284500000,
"contract_count": 412,
"top_agency": "Department of Defense",
"top_industry": "Aircraft Manufacturing",
"all_awards_all_time_usd": 3912000000
},
"insights": {
"federal_contractor_result": {
"top_agencies": [{ "name": "Department of Defense", "amount_usd": 1020000000 }],
"top_naics": [{ "code": "336411", "amount_usd": 702400000 }],
"data_source": "usaspending"
}
},
"metadata": { "credits_used": 3 }
}Every contractor lookup returns the same fields at one flat price
A figure the database could not give comes back as null and never as a guess, and every company with contract awards costs the same 3 credits.
Identity and match
- found
- outcome
- outcome_label
- name
- uei
- level
- parent_name
- parent_uei
- name_search
- name_match
Contract dollars
- window
- awards.window_start
- awards.window_end
- total_obligated_usd
- contract_count
- all_awards_last_12_months_usd
- all_awards_all_time_usd
- loan_face_value_usd
Agencies and industries
- top_agency
- top_agencies_list[]
- top_agencies[]
- top_industry
- top_naics[]
Company profile
- small_business
- business_types[]
- state
- location.city
- location.zip
- location.country
Several matches
- candidate_count
- candidates[]
- other_matches
- breakdown_note
Sales, lending and procurement teams check a contractor instead of searching the federal database by hand
Sales and business development teams selling to government contractors
Check whether a prospect really holds federal contracts, how many dollars it was awarded and which agencies pay it before a rep writes the first email, and sort a list by contract dollars.
Lenders and vendors vetting a counterparty
When a company says it works for the federal government, confirm it holds contract awards, see the agencies behind them and compare the total with the size of the credit or order.
Prime contractors looking for a teaming partner
Look up a small business that offered to subcontract, see whether it holds federal awards of its own, which agencies it serves and in which industry codes.
Procurement and compliance teams onboarding a vendor
Check a vendor's claim of federal experience at onboarding, and keep its UEI, small-business status and largest agency in the vendor file.
Market researchers sizing a field of competitors
Run a list of companies through a bulk job to pull each one's contract dollars and top agency over the same three fiscal years, then rank the list by federal work.
Marketing teams building a government-market list
Keep only the companies in a list that hold federal contract dollars, tag each with its top agency and industry, and leave out the ones with none.
Only a company with contract dollars in the window is billed, and every other answer is free
A name that clearly fits one company with contract dollars returns its record for one charge. A name that fits several companies, a company with no contract dollars in the window and a name nobody holds are not charged.
These are the questions people ask before they look up their first contractor
What does the Federal Contractor Lookup API return?
Send a company name or a 12-character Unique Entity ID (UEI) and it returns the company that holds the federal contracts: its name, UEI, whether the record is a parent, a child or a standalone registration, the parent company, its state and whether it is a small business. Then the contract dollars awarded over the last three completed federal fiscal years (FY2024 to FY2026 today), the number of contract awards, the top five agencies and the top five industries with their dollars, and the dollars of every kind of award in all years. A name that fits several companies returns up to five candidates instead.
Where does the contract data come from?
From the federal government's public spending database, the U.S. Treasury's record of what federal agencies award. It is public US government data and needs no account to read. We read it when you look a company up, so the answer is as current as the database is, and the window it covers is named in every answer.
Which years does the dollar total cover?
The last three completed federal fiscal years. A federal fiscal year runs from October 1 to September 30 and is named for the year it ends in, so today's window is FY2024 to FY2026, from 2023-10-01 to 2026-09-30. Every answer carries the label and the two dates, and the window moves forward each October.
What counts in the contract dollars, and what does not?
Contract awards only: definitive contracts, purchase orders, delivery orders and blanket purchase agreements, summed across every agency. Grants and loans are not in total_obligated_usd. The figure is obligations, the amount the government committed, not what was paid or what the company earned, and a de-obligation can lower it. The dollars of every kind of award in all years are returned separately as all_awards_all_time_usd, so that figure is larger.
How much does a contractor lookup cost?
3 credits per lookup, about $0.01 on the Starter plan. You are charged only when one company is clearly identified and has contract dollars in the window. A name that fits several companies, a name or UEI nobody holds, a company with no contract dollars in the window, a malformed entry and a lookup the database could not answer all cost 0 credits, in the API, the dashboard and bulk jobs.
What happens when a name fits several companies?
The answer says Several matches and lists up to five candidates, each with its name, UEI, level, state and the dollars it was awarded in the last 12 months, and charges nothing. Run the lookup again with the UEI of the one you mean. A partial name that fits more than one company is ambiguous by design, so a short name is never silently matched to the wrong one.
Why does a company come back not found?
No company in the database carries that name or UEI. A company that has never been awarded anything by a federal agency is not in the database at all, a company that was renamed may be listed under its other name, and a name with an apostrophe typed without it may not match. A not-found answer is found: false with outcome not_found and costs 0 credits.
What if the company is found but holds no contract dollars in the window?
It comes back found with a total of 0 and the recommendation VERIFY, and it is not charged. That happens when a company holds only older awards, or only grants and loans. all_awards_all_time_usd still shows what it was awarded in all years.
Can I look a company up by its UEI?
Yes. A UEI is the 12-character Unique Entity ID every federal contractor is registered under, and it always finds one company. Send it as uei, or as company: a single 12-character word is tried as a UEI first and read as a name if nobody carries it. When both a name and a UEI are sent, the UEI wins. A name is 2 to 150 characters, and case, accents and legal forms such as Inc or Corporation are ignored when matching.
What do parent, child and standalone mean?
A large company is registered many times in the database: a parent, its subsidiaries and look-alike registrations. level says which record you got: parent, child or standalone. A child comes back with parent_name and parent_uei so you can look up the group, and the dollars are those of the one registration the answer names.
How current is the answer, and can I ask again?
It is as current as the federal database, and the window and its dates are in every answer. A repeat lookup of the same company by the same user within one day comes from the cache at no charge. If the database cannot be reached, the API answers 503 with a Retry-After header, charges nothing and does not save the answer, so a retry is never a second charge.
Does it list the individual contracts?
No. It returns totals: the contract dollars, the number of contract awards, the top five agencies and the top five industries with their dollars. It does not list each award, name contract vehicles or return set-aside detail. A record with no UEI on file has no agency or industry breakdown, and a figure that could not be read comes back as null with a breakdown_note saying which.
What happens when a breakdown cannot be read?
Only that block is blank. If the agency, industry or award-count call fails, that value is null and breakdown_note says so, and the answer is still billed because the company's contract dollars were read. If the contract total itself could not be read, nothing is billed.
Can I check a list of companies at once?
Yes. Upload a CSV with a company column holding a name or a UEI in each cell and you get a row per company with its outcome, UEI, contract dollars, number of awards and top agency. A row with several matches or none is a free row, not a failure. The price stays at the same credits per company found, however long the list is.
To check a single company before you write any code, run it through the free federal contractor search.
The contract record says who pays a company, and these products check the rest
Here is how checking a federal contractor with 1Lookup compares with the other ways to read the federal record
Each page sets a rival's plans and prices beside ours and says where the rival does the job better. Every figure carries its source and the date it was checked.