Get Vehicle Holders
get_vehicle_holdersRead-onlyIdempotent
Check eligibility to bid on task orders by distinguishing vehicle holders from actual earners. Get awardee and earner counts plus related vehicle family PIIDs for compliance analysis.
Instructions
Get who holds a vehicle AND who's actually earning through it, two distinct populations, don't conflate them: a firm can hold a vehicle for years and earn nothing on it.
Award & Compliance tool, Pro only. The "can I even compete for this work" answer, on a multi-award vehicle, only holders can bid task orders.
- piid: vehicle's own PIID (from search_vehicles or get_contract_vehicle)
- limit: max 250
Returns `awardees` (hold the vehicle) and `earners` (have actually been paid through
it) as separate lists with counts (`awardee_count`/`earner_count`), on a real
multi-award vehicle these can be wildly different (e.g. 1,596 awardees, 2 earners),
which is the whole point of the distinction. Each entry's `recipient_uei` chains into
Capture/Teaming tools. Also returns `vehicle_family.piids`: this rolls up EVERY
related PIID under the same vehicle family, not just the one you asked for, so
`awardee_count` reflects the whole family, not a single order.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| piid | Yes | ||
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |