---
title: "Company profile with aggregated stats"
method: GET
path: "/api/v1/companies/{uei}"
tags: ["Companies (Pro)"]
---

# Company profile with aggregated stats

`GET /api/v1/companies/{uei}`

## Request

- Base URL: `https://govconapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://govconapi.com/api/v1/companies/{uei}`
- Auth: HTTP bearer

Aggregate profile for a single UEI.

Combines two sources:
  - **SAM entity registration** (legal name, DBA, address, NAICS, PSC,
    business-type certifications, registration dates, CAGE codes)
  - **Award history** (totals, top NAICS/agencies, activity windows)

**Scope of the award totals:** `total_awards`, `total_value`, and
`avg_value` count **SAM Award Notices only** (the SAM-noticed slice,
roughly 10-30% of federal obligations). They are NOT the company's total
federal contract value: a contractor active only in FPDS shows
`total_value: 0` here by design. For the fuller federal prime-contract
obligation figure read `fpds_obligated_total` (Pro), returned alongside.
The two are kept separate rather than summed because the sources overlap
at the award level (most SAM Award Notices also have an FPDS record) and
SAM `award_amount` carries occasional garbage values; pick the denominator
that fits your question.

Returns 200 if either source has the UEI. Returns 404 only when the UEI
is unknown to both. Award fields default to 0/empty when the company is
SAM-registered but has never won a contract (the common case for SMBs
in the SAM directory of ~880K registered entities).

## Path parameters

- `uei` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/govconapi/apis/govcon-api.md) · [All operations](https://skmtc.dev/govconapi/apis/govcon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govconapi/apis/govcon-api/revisions/32e498016218?raw)