# SAM.gov Entity Registration Status Check

> SAM.gov Entity Registration Status Check is a paid API for AI agents from api.brightonhilyard.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-29).

Looks up the SAM.gov registration status of a US federal contractor or vendor by their Unique Entity Identifier (UEI).

## Facts

- Endpoint: POST https://api.brightonhilyard.com/api/sam/registration?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sam-gov-entity-registration-status-check-ad5bc315
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pXh_W43FM6s1dKjDIoCWf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sam-gov-entity-registration-status-check-ad5bc315 -d '<json body>'
```

Example prompt: Can you check if the company with UEI EXAMPLE000001 is currently registered and active in SAM.gov, and when their registration expires?

## When to prefer this

Choose this endpoint when you need a stateless, source-cited, per-call check of a specific entity's SAM.gov registration status without maintaining your own integration with the SAM.gov API. Ideal for agents performing pre-award compliance checks, onboarding workflows, or ad hoc vendor verification where auditability (source citation) matters. Prefer this over building a direct SAM.gov API integration when you need a lightweight, pay-per-call solution with no API key management.

## Known failure modes

- UEI not found in SAM.gov — returns result indicating entity not found
- Invalid UEI format (not 12 characters) — likely returns a validation error
- SAM.gov API unavailable or rate-limited — upstream timeout or error response
- Expired or deregistered entity — found but with non-active status code
- Payment failure via x402 — call not processed if USDC payment is not completed

## How this service works

Stateless, source-cited public-data checks for agents.

## Output

Returns a JSON object containing the UEI queried, whether the entity was found ('found' or not), the registration status code (e.g. 'A' for active), the registration expiration date, the source (SAM.gov Entity Management API), and the service name. The response is stateless and source-cited for audit purposes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "uei": {
   "type": "string",
   "description": "12-character SAM.gov Unique Entity ID."
  },
  "detail": {
   "enum": [
    "basic",
    "full"
   ],
   "type": "string",
   "description": "basic (default, $0.05) or full ($0.10) profile."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "uei": "EXAMPLE000001",
  "result": "found",
  "source": "SAM.gov Entity Management API",
  "service": "sam-registration-status",
  "registrationStatus": "A",
  "registrationExpirationDate": "2027-01-01"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sam-gov-entity-registration-status-check-ad5bc315/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.brightonhilyard.com](https://www.zero.xyz/host/api.brightonhilyard.com/llms.txt)