Vehicle holders

Answers "can I even compete for this work, and who am I up against."

Holding a vehicle is what makes you eligible to bid the orders placed against it. On a multiple-award IDIQ, the competition for every order is the pool of firms that hold it. This endpoint returns that pool, and separately, the firms that have actually been paid through the vehicle.

Two populations, deliberately not merged

Block	Who they are
awardees	Firms holding the vehicle itself, an FPDS IDV record in their name. On a multiple-award IDIQ, this is the competed pool.
earners	Firms that have actually been paid through it, ranked by dollars obligated.

They are reported separately because they are genuinely different. A firm can hold a vehicle for years and earn nothing on it. Collapsing the two into a single "holders" list would tell you a firm is a competitor when it has never won an order, or imply a vehicle is contested when one incumbent takes all of it.

Response

curl -H "Authorization: Bearer $GOVCON_API_KEY" \
  "https://govconapi.com/api/v1/vehicles/N0003920D0054/holders?limit=3"

{
  "piid": "N0003920D0054",
  "awardees": [
    {
      "recipient_uei": "UE9QJD4KK1L6",
      "recipient_name": "LEIDOS, INC.",
      "ceiling": 7729639286.25,
      "latest_action_date": "2025-12-08"
    }
  ],
  "awardee_count": 1,
  "earners": [
    {
      "recipient_uei": "UE9QJD4KK1L6",
      "recipient_name": "LEIDOS, INC.",
      "orders": 5988,
      "obligated": 1257164494.67,
      "share_pct": 100.0,
      "latest_order_date": "2026-02-27"
    }
  ],
  "earner_count": 1,
  "_sources": ["usaspending_fpds"]
}

A single-award IDIQ, so one holder taking 100 percent. On a multiple-award vehicle you would see several awardees and a share_pct distribution across the earners.

Fields

Field	Meaning
awardees[].ceiling	The vehicle's ceiling as recorded on that firm's IDV record
earners[].orders	Distinct orders won through the vehicle (modifications collapsed)
earners[].obligated	Dollars obligated to that firm through this vehicle
earners[].share_pct	That firm's share of dollars flowing through the vehicle, 0 to 100

share_pct is null when the vehicle's net obligation flow is zero or negative. FPDS de-obligations are recorded as negative amounts, so a vehicle with heavy de-obligations can produce a ratio outside 0 to 100; rather than ship a nonsensical percentage, it is reported as null.

earners is ranked by dollars and capped by limit (default 100, max 1,000), so on a large vehicle the shares shown will sum to less than 100.

Parameters

Parameter	Type	Description
limit	integer	Earners returned, ranked by obligation. Default 100, max 1,000. Over it returns 402.

Plan

Pro. Developer and Free keys receive 402. The vehicle record itself is available on every plan via /vehicles/{piid}; this endpoint is the composed layer across vehicles and orders.

Returns 404 if the PIID is not a vehicle we carry.

Errors

Status	When
401	Missing or invalid API key
402	The key is not on Pro
404	The PIID is not a vehicle we carry