# federal-contractor-records

> https://federal-contractor-records.pages.dev

## What this site answers

One query, one record. Key: **the unique entity id**.
Format: ^[0-9A-Za-z-]{1,40}$
Entities: 17183

## Source

- Origin: U.S. Department of the Treasury, USAspending.gov — USAspending.gov — recipients of federal contracts, last 12 months
- URL: https://www.usaspending.gov/recipient
- Last collected: 2026-10-11
- Re-use: U.S. Government work (public domain)

## Access points

Every HTML page has a Markdown twin at the same path with the `.md` extension. Example: `/how-to-read/` -> `/how-to-read.md`. Links inside the Markdown files already point to the twins.

Search index, served as JSON with open CORS:

- `https://federal-contractor-records.pages.dev/d/n/cles.json` — the name-index keys
- `https://federal-contractor-records.pages.dev/d/n/<key>.json` — names starting with that key -> [identifier, name, city, state, type]
- `https://federal-contractor-records.pages.dev/d/r/<fragment>.json` — records; fragment = hash of the identifier: h = 0, then for each character h = (h*31 + character code) modulo 4096; in hexadecimal on 3 digits
- `/sitemap.xml` — every page

These paths are **version 1** and will not change without notice. Bulk access, an availability guarantee or a change feed goes through `/pro/`.

Indexable pages: 11

## What this site is NOT

- This is not the official register and does not replace consulting it.
- Holding a licence is the minimum legal requirement, not a quality mark.
- One record per identifier.
- No individuals.
- Amounts are obligations over the last twelve months on the collection date, not revenue and not a ranking. Larger and smaller contractors are not on this site. What the federal file says about a company's owner (origin, sex, veteran status) is not shown.
- This site ranks no one.

## Privacy

Only names carrying a company word are published; individuals are left out.