Skip to main content
POST
Returns the ceiling hourly rates contractors have agreed on US federal supply schedule contracts, from the US General Services Administration, with the low, middle (median), average and high across every match. These are ceilings, the most the contract allows per hour, not what was paid. The match is a keyword search, so a match is not always a job title.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
required
Words to look up, for example software engineer. Matched as a keyword search across labor category, contractor name and contract number, so some rates may not be for that job title. 2 to 80 characters.
integer
Only rates for roles that ask for at least this many years of experience. From 0 to 45.
string
Only rates for roles that ask for exactly this level of education. One of high_school, associates, bachelors, masters, doctorate.
integer
The most rates to list. The summary always covers every match. From 1 to 25. Defaults to 10.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always market_federal_labor_rates
object
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always US General Services Administration.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
number
How many rates match the keyword, including any beyond limit.
object | null
Null when nothing matches. null when the source gives no value.
number
How many rates the figures cover.
number
The lowest ceiling hourly rate.
number
The middle ceiling hourly rate.
number
The average ceiling hourly rate.
number
The highest ceiling hourly rate.
object[]
Rates.
string | null
The contractor’s name for the labor category. null when the source gives no value.
number | null
The ceiling hourly rate in US dollars. null when the source gives no value.
string | null
Contractor. null when the source gives no value.
string | null
Contract number. null when the source gives no value.
string | null
Business size. null when the source gives no value.
string | null
Education. null when the source gives no value.
number | null
Min years experience. null when the source gives no value.
boolean | null
Security clearance. null when the source gives no value.
string | null
Worksite. null when the source gives no value.
string | null
YYYY-MM-DD. null when the source gives no value.
string | null
YYYY-MM-DD. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • Your words are matched against the labor category, contractor name and contract number.
  • Each matching rate has the contractor, contract number, business size, education, years of experience, clearance and worksite. Rates are listed lowest first.
  • Use it to check whether a quoted hourly rate is in line with what the government pays.
  • Covers ceiling hourly rates on US federal supply schedule contracts.
  • total is 0 and summary is null when nothing matches.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}