OneGraph Source: Vehicle Identity Fields
The OneGraph StockCarSearch endpoint returns inventory records with several identifier
fields. Only vin identifies a vehicle reliably. This page gives the stability and
uniqueness of each field.
For endpoint details (URL, headers, pagination, GraphQL queries), see Audi Public API Sources.
VIN availability by market
Only some markets return vin in StockCarSearch responses:
| VIN present | Markets |
|---|---|
| Yes | ca, ch, kr, mx, nl, no, tw, us |
| No (null) | ar, au, az, bh, br, de, es, fr, gb, gr, ie, it, jo, jp, kw, lu, om, pl, sa, se, za |
Identity field reference
vin
17-character Vehicle Identification Number. Globally unique and stable. Null in the markets listed above.
id
Base64-encoded composite of dealer.id and commissionNumber. It changes when the
vehicle moves to a different dealer or its commission number is reassigned, so it is not
a stable identifier.
code.id (mapped to vehicle_lookup_code)
8-character website lookup code, such as AXFFG3YX. https://audi.{tld}/{code} shows
the vehicle's configuration or listing.
- Unique within a market snapshot.
- Stable while the vehicle stays at the same dealer.
- Reassigned when the vehicle moves to another dealer.
commissionNumber
Factory order or commission number, such as 505214159. It can change while the vehicle
stays at the same dealer, so it is not stable.
avpCode (mapped to audi_code)
A comma-separated configuration string with the vehicle's full specification. Its fields, in order:
- a number
- the model code
- the model year
- the paint code, four characters: the body color, then the roof color
- the interior code
- every PR code
On a single-tone car the paint code repeats the body color (6Y6Y). On a two-tone car it
differs (6YA2), and colorInfo has the body color 6Y alone.
Every vehicle with the same configuration has the same avpCode, so it describes a
configuration and cannot identify a vehicle.
Model fields
model.id
The model identity, in four parts: code, version, year and extensions (a list of
PR codes).
The first entry of extensions is empty, as in ["", "S0D", "6W9"]. It is not a PR code.
No trimline field
stockCar has no trimline field at any depth. The trim name appears only as free text
inside model.name (Audi Q4 Sportback e-tron Premium Plus 55 e-tron® quattro®) and
subtitleText (Premium Plus 55 e-tron® quattro®).
salesModelyear
On model, beside model.id. The gen-1 vtp table, from which the historic partitions are
rebuilt, has no salesModelyear. VIN position 10 has the same year.
model.name
Begins with the brand and carline, as in Audi S8 L TFSI® quattro® tiptronic®.
carPrices
The manufacturer list price has the type list. The response has no MSRP or msrp
type. Each price applies to the vehicle record it appears on.
US records also have these types:
dealerDiscount, which is negativesaledealerMarkupdealerDocFeesdealerPricefinal
Not every record has every type. A missing dealerMarkup, dealerDiscount or
dealerDocFees counts as 0 in the relations below.
The relations below hold on most US vehicles:
| Relation | Applies to |
|---|---|
dealerPrice = list + dealerDiscount + dealerMarkup + dealerDocFees | Vehicles with list and dealerPrice |
sale = dealerPrice − dealerMarkup − dealerDocFees | Vehicles with sale |
carPrices is null on some vehicles. The response's errors has no entry for it. A later
response for the same vehicle has the prices. Nearly every vehicle with a null carPrices
is not yet in dealer stock.
final and dealerPrice
final is dealerPrice minus the vehicle's Audi of America national customer credit,
which carPrices does not list. The vehicle's REBATE1 dynamic attribute has the credit's
amount (see dynamicAttributes: REBATE1). The amount depends on the
model and model year. It is 0 on almost every vehicle that is not yet in dealer stock.
At some dealers, dealerPrice − final on every vehicle they list differs from the amount on
the same model at other dealers. The dealers below are dealer.id values in the US dealer
stock of 2026-10-21.
dealer.id | dealerPrice − final |
|---|---|
USA03C02, USA05A49, USA05A54, USA05A70, USA08B03, USA22A22, USA22A41, USA22A50, USA22A63, USA22B02 | 0, and their vehicles have no REBATE1 |
USA08A21 | 175 less than the vehicle's REBATE1 Amount, or −175 on a vehicle without REBATE1 |
USA08A88 | 699 less than the vehicle's REBATE1 Amount, or −699 on a vehicle without REBATE1 |
No carPrices type has the 175 or 699.
dynamicAttributes: REBATE1
dynamicAttributes is a list of {id, value} pairs. The entry with id REBATE1 describes an
offer the vehicle qualifies for. Its value is a JSON string. The string encodes an object with
these keys:
| Key | Type | Example |
|---|---|---|
Amount | integer, dollars | 2000 |
OfferName | string | 2027 Audi Q8 Premium Plus quattro - Customer Credit |
OfferDescription | string | The full program disclaimer, listing every model's amount |
OfferStartDate | ISO-8601 UTC | 2026-10-01T04:00:00Z |
OfferEndDate | ISO-8601 UTC | 2026-11-03T04:59:59Z |
OfferName begins with the model year and ends with the program name, such as Customer Credit
or Audi Credit. Every vehicle with the same OfferName has the same Amount, OfferStartDate
and OfferEndDate. The wording of their OfferDescription can differ. One OfferName can
cover two model codes, as 2026 Audi A3 Premium quattro - Customer Credit covers 8YMBUY and
8YMCUY.
REBATE1 appears in every sampled US partition from 2026-04-22, the first OneGraph
partition, except 2026-05-01, where no vehicle has it. Most vehicles in dealer stock have
it, and few vehicles in transit or at port do.
engineInfo.fuel
{code, text}, with text in plain English (Gas, Electric).
driveText and gearText
driveText is a phrase, such as All-wheel drive. gearText is null on US records, and
the transmission appears inside subtitleText instead.
doors
0 on every US record.
Feature fields
A stockCar lists its equipment in three places. None of them has a price or the package
an item belongs to.
features[]
One entry per labeled PR code: text, featureType and prNumber { family code class }.
A US vehicle has about 90 entries. text contains HTML entities (", &,
'), non-breaking spaces and ® marks.
featureType is SERIES or SPECIAL, and prNumber.class subdivides it:
featureType | class | Entries |
|---|---|---|
SERIES | L | standard equipment |
SERIES | I | body style, drivetrain, battery, transmission |
SPECIAL | P | individually priced options |
SPECIAL | G | packages, including the trim packages WPS and WPT. family is empty and text is sometimes only the code. |
SPECIAL | E | options such as tires, a trailer hitch, a sound system |
For a few (model, trim, code) combinations, the same code is SERIES on one vehicle and
SPECIAL on another, and the text of a code can differ between vehicles.
colorInfo
exteriorColor and interiorColor each have colorInfo { code text },
baseColorInfo { code text } and label. Both colorInfo.code values are two characters
on US vehicles, such as 2Y "Glacier White metallic" and EI "Black with Rock Gray
stitching". baseColorInfo is the generic color family, such as 04 "White".
exteriorColor.label is Exterior or null. interiorColor.label is null.
avpCode
A US vehicle's avpCode has about 190 PR codes after the fifth field (see
avpCode above). About half have no features[] entry.
Most of those are build and regulatory codes, such as "Without fire extinguisher" and
"User manual in American English", and a few are equipment codes.
avpCode lists a vehicle's PR codes every day, while features[] omits some of them on
some days. On the US feed between 2026-10-02 and 2026-10-03, avpCode changed on one
vehicle and features[] changed on 1,795. Every code missing from a vehicle's
features[] was still in its avpCode. The codes most often present in features[] on
one day and absent on another:
3Y4, manual rear side window sunshades4D3, ventilated front seats8RT, Bang & Olufsen sound system with headrest speakersH5F, 19" all-season run-flat tiresHX9, 18" all-season tiresQK5, dashcam
See OneGraph vehicles for how the pipeline
combines avpCode and features[].
The partitions through 2026-04-21 are rebuilt from the gen-1 vtp table (see
source coverage). Their avpCode holds the
lookup code, which has no PR codes.
At most one member per PR family
A vehicle's avpCode has at most one member of each PR family of equipment, such as one
headliner or one sound system. SNR is the exception. It holds notes about the car rather
than equipment, and an RS Q8 can have both S0D "Matrix function deactivated in the
headlamp" and S3G "Audi Sport GmbH special equipment".
Precedence between the sources of a member
The model's standard equipment, the trim, each package on the car and the interior can
each name a member of the same family. Where they name different members, the avpCode
has the member from the source with the highest precedence, and the displaced member is
absent. In the diagram, each arrow points from a source to the source it displaces:
option that requires a package
|
v
package
/ \
v v
trim interior
\ /
v v
model
- A package displaces the trim. On the 2026 A6 Sedan (
FN2A5Y), the S line exterior package's2K7"S line exterior" replaces the trim's2K5"Advanced line front and rear bumpers". - A package displaces the interior. On the 2026 Q7 Prestige (
4MQCX2), the Luxury package's6NS"Dinamica headliner" replaces the Black interior's6NQ"Black headliner". - A trim displaces the model. On the 2026 A6 Sedan, Premium Plus's
4A4"Heated front and rear seats" replaces the model's4A3"Heated front seats". - An interior displaces the model. On the 2026 Q5 (
GUBAAY), theOVinterior's6NQ"Black cloth headliner" replaces the model's6NJ"Light cloth headliner". - A package displaces the model. On the 2026 Q5, the S line exterior package's
3S2"Black roof rails" replaces the model's3S1"Aluminum roof rails". - An option displaces the package it requires. On the 2027 RS Q8 (
4MTRR2), the 23" matte gray wheels64Ireplace the Black optic package's64H23" bicolor wheels.
The diagram has no arrow between the trim and the interior. No model measured so far has a
seat interior and a trim that name different members of one family.
ai_audi.components.enriched.refs ranks the interior above the trim's standard equipment
without that measurement.
A package's member can depend on the interior. On the 2026 Q7 Prestige, the Luxury
package has 6NS with a black interior and 6NN "Moon Silver Dinamica headliner" with
the Saiga Beige interior. The catalog's content rows for the package list only 6NN.