---
title: "Single contract vehicle — ceiling, period, and what has been ordered through it"
method: GET
path: "/api/v1/vehicles/{piid}"
tags: ["Vehicles"]
---

# Single contract vehicle — ceiling, period, and what has been ordered through it

`GET /api/v1/vehicles/{piid}`

## Request

- Base URL: `https://govconapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://govconapi.com/api/v1/vehicles/{piid}`
- Auth: HTTP bearer

Latest transaction for the vehicle, plus two roll-ups.

Detail shape per §1.2: singular `vehicle` key with the roll-ups as SIBLINGS,
not nested inside it.

`orders_rollup` is the block that makes this endpoint worth calling: the
vehicle's own transactions carry the CEILING, but the money moves on the orders
placed against it, which live in the contracts table. A vehicle without its
orders is a stub.

`transaction_rollup`/`orders_rollup` are deliberately scoped to THIS ONE PIID,
matching how USAspending's own IDV award view works (verified against their
public API contract 2026-08-29: a single award's child-orders view has no
cross-awardee aggregation option). On a multiple-award IDIQ, every awardee
holds a SEPARATE PIID, so `distinct_awardees` here can never exceed 1 , that
is a structural fact, not a bug, and family-blending the money/order numbers
would answer a different question than the one the URL asked. What WAS
missing: any signal in this response that the vehicle is part of a larger
family at all. `vehicle_family` below closes that gap cheaply (reusing the
same `vehicle_family_piids()` resolution `/holders` already proves out)
without touching what the roll-up numbers mean.

## Path parameters

- `piid` string, required

## Query parameters

- `fields` string, nullable: lean | expanded | full | comma-list of columns

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/govconapi/apis/govcon-api.md) · [All operations](https://skmtc.dev/govconapi/apis/govcon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govconapi/apis/govcon-api/revisions/32e498016218?raw)