Federal Contractor Lookup
Federal contracts a company has won, top agencies and small-business status.
curl -X POST https://api.1lookup.dev/v1/federal-contractor-lookup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"Northwind Logistics Inc"}'{
"success": true,
"data": {
"company": "Northwind Logistics Inc",
"uei": "EXAMPLE12345",
"cage_code": "1EX42",
"sam": {
"registered": true,
"registration_status": "active",
"expiration_date": "2027-03-14",
"small_business": true,
"set_asides": [
"Service-Disabled Veteran-Owned Small Business"
],
"primary_naics": "484121"
},
"awards": {
"total_obligated": 18452300,
"award_count": 37,
"first_award_date": "2017-09-28",
"latest_award_date": "2026-08-11",
"top_agencies": [
{
"agency": "Department of Defense",
"obligated": 12110400,
"awards": 21
},
{
"agency": "General Services Administration",
"obligated": 4206900,
"awards": 11
}
],
"recent": [
{
"award_id": "W91EXAMPLE26C0012",
"agency": "Department of Defense",
"description": "Freight transportation services",
"obligated": 842000,
"start_date": "2026-08-11"
},
{
"award_id": "47QEXAMPLE26F0431",
"agency": "General Services Administration",
"description": "Warehousing and distribution support",
"obligated": 215500,
"start_date": "2026-05-19"
}
]
}
},
"meta": {
"credits_used": 3,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
companystringrequiredCompany name or UEI. Example: Northwind Logistics Inc
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.ueistringThe 12-character identifier SAM.gov assigns to the company.
data.sam.registration_statusstringWhether the company's SAM.gov registration is active or expired.
data.sam.small_businessbooleanWhether the company is registered as a small business.
data.sam.set_asidesarraySocioeconomic categories on the registration, such as veteran-owned or woman-owned.
data.awards.total_obligatednumberDollars obligated to the company across its federal awards.
data.awards.award_countnumberThe number of awards behind that total.
data.awards.top_agenciesarrayThe awarding agencies that account for the largest share of the dollars.
data.awards.recentarrayThe latest awards with agency, description, amount and start date.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
3 credits. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases