Audi Public API Sources
Audi exposes its data through three public APIs, ingested by the ai_public code location.
No API keys or partner credentials are required. All endpoints are the same backends
the www.audiusa.com website and the other market sites call from the browser.
Postman collection. The four ingested endpoints are runnable requests in the Audi folder
of the "Public OEM APIs" collection, in the
AutoIntel Workspace.
The collection is the system of record. The folder also has older requests, labeled
[LEGACY / UNUSED]. The ingested requests are:
StockCarSearch — inventory (ingested)CarlineStructure — models (ingested)dealersByMarket — dealers (ingested)CatalogForModel — features (ingested)
Market coverage
All three APIs take a market parameter. Neither GraphQL endpoint allows introspection, so there is no authoritative market list. The coverage below is the set of markets that returned data when every ISO 3166-1 alpha-2 country code was requested.
The pipeline ingests full-coverage markets only. Each is configured in
defs/<oem>/<market>/raw/defs.yaml, with the assets its APIs serve:
| Tier | Assets | Markets |
|---|---|---|
| Full | dealers, carlines, catalog features, inventory | ar, au, az, bh, br, ca, ch, de, es, fr, gb, gr, ie, it, jo, jp, kr, kw, lu, mx, nl, no, om, pl, sa, se, tw, us |
The partial tiers below are kept as discovery records in
defs/<oem>/<market>/raw/defs.yaml.disabled. Dagster ignores them until an onboarding
renames the file to defs.yaml and adds the matching template vars and transformed defs:
| Tier | Available API data | Disabled markets |
|---|---|---|
| No inventory | dealers, carlines, catalog features | be, dk, fi, in, th, tr |
| Dealers only | dealers | at, bg, cz, hu, my, pt, ro, rs, si, sk |
"No inventory" markets return a carline structure but no stockCarSearch results.
"Dealers only" markets return an empty carlineStructure.carlineGroups, because they are
not on the OneGraph stack. PSS dealersByMarket returns rows for nearly every country,
many with one or two import dealers, so a dealer count alone does not show that a market
exists. Several more countries return carline structures and could be onboarded the same
way: nz, hk, eg, sg, qa, lb, and most of Central America and the Caribbean.
Requesting another language does not change a market's tier:
- The API rejects region variants such as
de-AT. - Dealers-only markets return no OneGraph data in any language.
- No-inventory markets return carlines only in their configured languages. No language
returns stock for them, with
stockCarsType: USEDorNEW.
Every language that has returned data is in the country's CLDR territory-language set or
is en. Re-verifying a market therefore needs only those languages.
For a market with several site languages, one is ingested: ca as en, be as nl,
ch as de, lu as fr. The languages return the same inventory counts. Only display
text differs.
API Domains
| Domain | Used for |
|---|---|
omnigraph.audi.com | Inventory (StockCarSearch) and model structure (CarlineStructure) |
graphql.pss.audi.com | Dealer locator |
web-api.audi.com | Feature and option catalog per model |
Raw dependency graph
| Node | Raw asset | Upstream | Source |
|---|---|---|---|
| a | audi/us/raw/onegraph_models | none | OmniGraph CarlineStructure |
| b | audi/us/raw/catalog_features | a | Web-API CatalogForModel per model_id |
| c | audi/us/raw/onegraph_inventory | none | OmniGraph StockCarSearch |
| d | audi/us/raw/pss_dealers | none | PSS dealersByMarket |
OmniGraph GraphQL API
POST https://omnigraph.audi.com/graphql
The Akamai edge answers 403 on the inventory endpoint for specific
(apollographql-client-name, apollographql-client-version) pairs. The pairs are stale
versions of Audi's own frontend client, fa-vlp-list-page: 5.16.0, 5.17.0, 5.20.0
and 1.0.0 are denied, and the versions between them are not. The list is discrete:
there is no minimum version. The result does not depend on the egress IP.
Required headers:
| Header | Inventory | CarlineStructure |
|---|---|---|
apollographql-client-name | audi-data-platform | audi-data-platform |
apollographql-client-version | 1.0.0 | 1.0.0 |
content-type | application/json | application/json |
audi-data-platform 1.0.0 is our own client identifier, and the deny-list does not
include it. The endpoint is unauthenticated. origin and referer are not required, and
neither changes a 403.
CarlineStructure (node a)
carlineStructure(identifier: {country, language}) returns a market's whole model
hierarchy in one request, for the current and the next model year. The tree holds carline
groups, carlines and trimlines, and per model its modelId { code version extensions year },
prices and technicalDataV2.modelAttributes. There is no endpoint per model, year or trim.
The models drive the catalog_features requests (node b).
StockCarSearch (node c)
Returns a market's new-vehicle stock, paginated by offset. The first page's
resultNumber is the total.
stockCarSearch(stockIdentifier:, searchParameter:) returns resultNumber plus
results.cars[].stockCar. stockIdentifier takes a marketIdentifier
(brand, country, language) and a stockCarsType. searchParameter takes paging,
sort and criteria. The stockCar fragment holds the vehicle (vin, avpCode,
commissionNumber, weblink), model, carline, code, colorInfo, dealer,
engineInfo, features, carPrices, dynamicAttributes, salesInfo and images.
Sort. Valid sort ids differ by market. An id the market does not know fails the
whole request with IllegalSorting. A request without sort pages in the market's
default order, which the response reports in results.sort. The fetch sends no sort.
- AR, BR, GR, KR, MX, SE and TW accept only
STAT_GWPLUS, which is also their default. - The other markets accept
DATE_PREDATEENDandDATE_OFFER, and default toDATE_OFFER. - The US accepts
STAT_GWPLUSbut sorts byDISTANCEinstead.
Images. images(groupIds:, imageIds:) returns one entry per id in imageIds, with
url, type, mimeType and id { group image }. An empty imageIds returns an empty
list whatever groupIds asks for. Under groupIds: ["renderImagesPNG"], the urls are PNGs
at https://mediaservice.audi.com/media/fast/...png, rendered with the vehicle's own color
and options. Each id in imageIds adds render work for every vehicle on the page, so
responses get slower as the set grows.
Known image ids. The sc4* set has a transparent background, sc3* is a wide crop with a
transparent background, sc5c01 is a small 350x196 render, and vtp4x3* has a background
scene:
| View | Transparent | Transparent wide | With background |
|---|---|---|---|
| Front | sc4c03 | sc3c03 | vtp4x3n3c |
| 3/4 front | sc4c01 (small: sc5c01) | none | vtp4x3n1c |
| Zoom 3/4 front hood | sc4c02 | none | vtp4x3n2c |
| Zoom 3/4 front bumper | none | sc3c02 | none |
| Side | sc4c14 | sc3c14 | vtp4x3n8c |
| 3/4 rear | sc4c12 | sc3c12 | vtp4x3n6c |
| Rear | sc4c11 | sc3c11 | vtp4x3n5c |
| Interior, rear-facing angled | sc4n05 | sc3n05 | vtp4x3i1n |
| Interior, front-facing near-straight | sc4n06 | sc3n06 | vtp4x3i2n |
groupIds: ["dealerImages"] returns dealer photos instead of renders
(https://vtpimages.audi.com/carimg2/...jpg, resizable with im=Resize query params).
Its image ids are integers as strings, counting up from "1", with no fixed maximum; a
vehicle can have more than 12. Not every vehicle has dealer photos, and fewer vehicles have
the higher ids. One request can combine groups. Each imageIds entry is looked up in every
group in groupIds, and a (group, id) pair with no image is absent from images.
Pagination. offset is searchParameter.paging.offset, with .limit. resultNumber
from the first response gives the total, and a short or empty page ends the pass.
Page size. A limit of 250 or more returns a GRAPHQL subgraph error. The fetch uses
100.
Coverage. The fetch sends no geo or criteria filters. criteria: [] returns the
market's whole stock in one paginated pass.
features.featureType: standard versus optional equipment
OmniGraph does not allow introspection. The meaning of featureType, and of the fields
below, comes from the TypeScript source of Audi's Tier 3 dealer VDP apps
(fa-vdp-feature-and-specs, fa-vdp-pricing-bar, fa-vdp-pricing-breakdown), which read
the same schema in the browser.
featureType is SERIES for standard equipment and SPECIAL for optional equipment. The
dealer frontend builds its standard and optional tabs from this value. The full set of
values is unconfirmed.
manufacturerSpecificItems.cdbCategories: investigated, not ingested
cdbCategories (under manufacturerSpecificItems { ... on StockCarManufacturerAudi })
groups features into a tree of category, subcategory and feature, with marketing text per
feature (textInfos { name details benefits }, imageResources). For US vehicles:
- The cdb features are a subset of
stockCar.features. CDB is a content database, so membership follows marketing display content, not the ordering configuration. - Trim packages such as
WPSare absent fromcdbCategorieson every model, whether the package is the trim default or a paid second tier. TheconfiguredCarquery's feature lists omit them the same way. The absence of a code from cdb therefore does not show whether it is a default or an option. Only inventorystockCar.featuresincludes package codes. - Many
SERIESfeatures are also absent from cdb. It is a curated display list and does not list all standard equipment. - CA and DE return
manufacturerSpecificItemswith no cdb feature codes.
AccessAudi, the private ordering side, omits a package code only when the package is the trim default.
carPrices: full price breakdown
Each carPrices entry has type, label and price.value. The price object also has
valueAsText and formattedValue, which are display strings. The price types below come
from the frontend's priority-order constants. Audi can add types without a schema change,
so the list may be incomplete:
- US, new:
list,OEMDiscount,dealerMarkup,dealerDocFees,destinationAndHandlingFees,dealerDiscount,dealerPrice,nonConditionalBonus,sale - Canada, new: adds the levies
freightPDI,acLevy,tireLevy,motoCouncil,adminFee,luxuryTax - Used: adds
final
US vehicles have list, dealerPrice, sale, final, dealerDiscount, dealerMarkup
and dealerDocFees. dealerDiscount values are negative. label is null.
Additional fields observed
These fields are valid in the OmniGraph schema. Each appears either in www.audiusa.com
traffic or in the source of Audi's frontend apps:
| Field | Description |
|---|---|
stockCar.techDataGroups { id label techDataList { id text label } } | Full per-car technical specs (displacement, max output and torque, transmission, suspension, brakes, steering, top speed, acceleration, fuel consumption, weights, cargo). Group and item ids differ by market. US uses engine, drivetrain, suspension, brakes, fuelconsumption; international markets use power, driveline, chassis, brake-system, fuel-consumption, performance-data, volumes. Model-level attributes. |
stockIdentifier.stockCarsType: "USED" | The same endpoint returns used stock with mileage, qualityLabel and preUse { code text }. |
stockCar.metaData { statImport } | The feed a record came from. AGC_USA_JDP and AGC_CAN_JDP are the JD Power feed. |
stockCar.modelInfo.genericModel { code text } | Generic model code, beside model |
stockCar.modelInfo.modelyear | Model year, the same as model.salesModelyear |
stockCar.qualityLabel { label } | Quality label, such as Certified Pre-Owned |
stockCar.cartypeText | Car type text |
stockCar.preUse { code text } | Pre-use classification |
stockCar.descriptionByDealer | Free-text dealer description |
stockCar.colorInfo.*.imageUrl | Swatch image URLs per color |
stockCar.carPrices.disclaimers { id legalEntityKey text } | Legal disclaimer text per price line. Returned only by the StockCar query. |
cars.geoDistance { unitText value { formatted number } } | Distance from a geo anchor. Set only when searchParameter has geo. |
search.criteria[].possibleItems/selectedItems | Facet counts per filter dimension |
Search criteria ids. stat-import, and t_vin, a VIN filter.
Frontend brand codes. The mediaservice render API
(https://mediaservice.audi.com/renderapi/v1/urlsvin) takes us=50710 and ca=50720
for VIN imagery.
StockCar: one vehicle by id
stockCar(stockCarIdentifier: { stockIdentifier:, id: }) returns the one vehicle whose
stockCar.id is id. It accepts the same stockCar selection set as StockCarSearch. The
vehicle it returns matches its copy on a StockCarSearch page, except for the order of the
carPrices list.
A field error on this query has a path that starts at stockCar, such as
["stockCar","model","id","version"]. A request that omits that field returns the rest of
the vehicle, as it does for a vehicle on a StockCarSearch page.
A request for an id that is absent from the market's stock returns data.stockCar: null.
The response's errors list has a VTP_API_ERROR at path ["stockCar"] with
extensions.subCode 2003 and the message "Could not find a car for given URL within VTP
API." The gateway reports a missing field with subCode 2001.
usCustomerOffers: national and regional offers
usCustomerOffers(zipCode: String, asOfDate: String, hideLeaseOffers: Boolean) returns the
offers on https://www.audiusa.com/en/offers/. The page embeds the same query's result. A
POST request needs only the apollographql-client-name header, and no credentials.
The audiusa.com fa-us-promotions app declares asOfDate and an older offerMonth.
Each offer has these fields:
programNameofferTypecreditBonusaprRatetermmonthlyPaymenttotalDueAtSigncustomerDownPaymentprogramFromDateandprogramToDate, asYYYYMMDDregionzipClusterIDofferDisclaimerofferModelDetail, with the model code, model year, family, trimline and MSRPstackableOffers
programName, offerType and region each label an offer. Responses to requests with an
asOfDate from 2026-04-22 to 2026-10-21 have these values:
-
programName:AUD_CUSTOMER_CREDIT,AUD_CREDIT,AUD_LOYALTY,AUD_APR_SUBVENTION_SPENDandAUD_LEASE_SUBVENTION_SPEND -
offerType:credit,financeandlease -
region:USA, and the region codesANE,ASE,AUC,AUW,CA,FL,GAandTX -
Location.
zipCodeis a five-digit ZIP. The server maps it to a pricing cluster and returns that cluster inzipClusterID, such asNew England Area(285). An offer priced the same everywhere hasregionUSA. In some ZIPs, thezipClusterIDof such an offer is the cluster name, and in others it isUSA. Its other fields are the same in every ZIP. -
History.
asOfDate(YYYYMMDD) returns the offers in force on that date, back to at least 2026-04-22. EveryasOfDatefrom one offer period'sprogramFromDateto itsprogramToDatereturns the same response. The last day of May and of July 2026 returns every row twice. AnasOfDateafter the current offer period returns no offers.offerMonth(YYYYMM) returns theasOfDateresponse for the 5th of that month. -
Coverage. No response from 2026-04-22 to 2026-10-21 has a MY2027 offer. Vehicles'
REBATE1credits include models that usCustomerOffers omits, such as the MY2027 Q8 at $2,000 and the June–August 2026 A8 at $10,000. Where both list a model, the amounts agree.
Known data quality issues
dealer_mat_primary_code: the same VIN listed under two dealers during transit
StockCarSearch returns two records for one VIN while the vehicle is in transit between dealers:
- One record is the vehicle as allocated and priced at the receiving dealer
(
vehicle_order_status: "Dealer Stock", non-nullmsrp). - The other is an open allocation at the originating dealer
(
sale_order_type: "SHIP - Deliverable Inventory Order", null pricing).
Both are current line items in Audi's order management system. The weblink field
resolves to the inventory page of the dealer that has the vehicle now. No scalar field in
the response identifies that record without resolving the URL.
StockCarSearch: subgraph failures arrive as HTTP 200
OmniGraph is a GraphQL federation gateway. When its stockcar-graphql subgraph returns a
body that is not JSON, the gateway answers HTTP 200 with this body instead of an error
status:
{"data":null,"errors":[{"message":"HTTP fetch failed from 'stockcar-graphql': expected value at line 1 column 1","path":[],"extensions":{"code":"SUBREQUEST_HTTP_ERROR","service":"stockcar-graphql","reason":"expected value at line 1 column 1"}}]}
About 2% of requests fail this way, whatever the offset or concurrency, so most full passes over a market have at least one. The same request succeeds on an immediate retry.
A failed response has cache-control: no-store. A good response has public, max-age=3600, s-maxage=3600, but no cache in the request path applies it: responses have
no age header, and resultNumber changes between calls seconds apart.
StockCarSearch: per-field errors arrive beside a complete page
A response with an errors list can still be usable. The gateway reports a missing
per-vehicle field as a VTP_API_ERROR entry beside a full page of cars:
{"message":"VTP API system did not deliver a required data field.",
"locations":[{"line":1,"column":1053}],
"path":["stockCarSearch","results","cars",87,"stockCar","model","id","version"],
"extensions":{"code":"VTP_API_ERROR","subCode":2001,"service":"stockcar-graphql",
"id":"b55becda-ced7-4a2b-bf30-b22955e05859",
"exception":{"message":"Exception details removed. Please use the error extension field 'id' to retrieve exception details from the StockCar subgraph log."}}}
The field in path is non-null in the schema, so the null propagates to the nearest
nullable parent. For the path above, that is the car's whole model block, with
model.id.code, .year, .extensions and model.name. The rest of the page is complete:
resultNumber is present, every car is there, and the affected car's stockCar keeps its
other fields.
The missing field is fixed per vehicle, so a retry fails the same way. How often a page
has one varies by market: pages from es, kr and fr had them, and pages from pl,
us, jp, au, de, gb and it did not. The count also varies by day. In ca,
about 200 vehicles a day had a missing field through 2026-10-02. On 2026-10-03, 1,838
vehicles had one, and each of them was missing model.id.version.
For each vehicle with a missing field, the source requests the vehicle again by id with
that field left out of the query. When the gateway refuses a whole page, the source
requests that page again, either split into halves or with the named fields left out.
Each market's fetch sends at most AUDI_ONEGRAPH_MAX_REPAIR_REQUESTS of these follow-up
requests in total, 10,000 by default. A vehicle whose follow-up request the limit prevents
counts as a failed request in the fetch_attempts check.
StockCarSearch: omitting the named field returns the rest
The field an error names is missing only because the query asked for it. The same request with that field left out of the selection returns the rest of the subtree and no error.
The gateway can also refuse a whole page over one vehicle's field, answering data: null.
Such a page fails with the full query at limit 100 and 50 alike, while each of its
vehicles reads alone at limit: 1. Leaving the named field out of the query is the only
way to read the page.
StockCarSearch: page order is not fixed between requests
Page order changes between requests in the US and TW, the two markets measured, whether or
not the request sends a sort. A request at the offset where a vehicle appeared can return
a different vehicle. In TW, vehicles tied in the STAT_GWPLUS order change positions
between two identical requests.
PSS GraphQL API: Dealer Locator (node d)
POST https://graphql.pss.audi.com/
Authentication: dynamic client ID
The PSS API requires a clientid header. The value changes, so the fetch reads it from
the Audi Market Context Service before every dealer request:
GET https://oneaudi-falcon-market-context-service.prod.renderer.one.audi/api/market-context
?path=/content/dam/country/us/configurations/config---market-context
&aemEnvironmentId=p119811-e1162341
&aemEnvironmentService=publish
The response is {"clientId": "<value>", ...}. The clientId value is sent as the
clientid request header to the PSS endpoint.
Dealers query
dealersByMarket(market: $market) returns dealers, with dealerId, matPrimaryCode,
kvpsId, name, address, houseNumber, street, city, region, zipCode,
latitude, longitude, phone, fax, url, services, additionalData (display name,
location image, additional URL) and openingHours (day schedules per department).
url is the dealer's website: https://www.audiusa.com or null for a dealer with no
site of its own.
One A-USA call returns every US dealer, each with a valid, non-zero latitude and
longitude. Inventory's stockCar.dealer.id matches matPrimaryCode (USA01A23).
dealerId is a second identifier with an extra brand letter (USAA01A17).
Market coverage. The market variable is A-<ISO alpha-3>: A for the Audi brand
and the market's 3-letter country code, such as A-USA. The market sites use the ISO
alpha-2 code (us). One request returns all of a market's dealers. See
Market coverage.
Audi Web-API: Feature Catalog (node b)
GET https://web-api.audi.com/vsapi/v1/us/en/CatalogForModel?model={model_id}
No authentication. One request per model id. The model ids come from CarlineStructure, plus probed next-year ids for the US. An unpublished id returns 404. For a given model code and catalog year, only one version digit is published at a time.
The response has no model identifier: neither the requested model id nor a model code
or year.
Response structure. featuresData contains the category lists accessories,
bodyColors, extColors, groups, interiorTiles, roofColors, specialGroups and
stealthItems. Each holds equipment families and equipmentList items with id (PR3
code), name, price, type, mbvId (PR7), renderCode, benefits, media,
attributes, and optional content (package sub-items).
stealthItems. stealthItems lists the model's codes that the configurator does not
offer as a separate choice. These codes are:
- some standard equipment;
- build codes and type-approval codes, such as
C02; - options that are available only as part of a package or an interior.
A code in stealthItems can also be in groups. The configurator still does not offer such
a code as a choice. It shows the code at most as a sub-item of a package.
AccessAudi, the ordering system, lists almost none of these codes as options. It can list
a package that the configurator offers under a different code. AccessAudi then orders the
package by its code in stealthItems.
On a trim's page, such as 4MT5X20S0DWPT_2027, the standard stealth items include codes
that come with optional equipment, such as the tires of optional wheels. The WPT page of
the 2027 Q8 lists H7J, the tire of the 23" wheels in the Sport plus package, as standard
beside the model's standard tire H8U.
Package names. A package-scoped item (X_in_Y) has its package's name in three
places: packageName, and the (contained in <package>) phrase in both
texts.ak_headline and texts.importname. They do not always agree. packageName matches
the name on the package's own row, while the importname phrase sometimes differs. A
package's name can also differ between models. One option code can name different packages
on different models: PSU is Individual contour seat package on 4KARRA and
Colored seat belts on G8BSVA.
Package benefits and content. benefits is free text, and content lists the
coded sub-items. They are written separately and can disagree: for PFZ on the 2026
4MQCX2, benefits describes 20-inch wheels and content 21-inch ones. The printed order
guide agrees with content.
Feature texts. texts.ak_headline describes the feature as this model has it, and
for one code it can differ between models. texts.importname is a label for the PR3 code
and rarely differs between models, so for some models it names a different feature. For
9VS on the 2026 RS 3 and S 3, ak_headline is SONOS® Premium sound system with 3D sound
and importname is Bang & Olufsen® Sound System. Where the two name different features,
the printed US order guide agrees with ak_headline. Where ak_headline is only the code,
as for WPT, importname has the name (Prestige package).
equipmentList.name is ak_headline with any (contained in ...) suffix removed. A row
without an ak_headline takes name from importname the same way, with two exceptions:
- On
K_...interior-color rows,nameadds the trim's color names. - On some package-content rows,
namematches neither text.
Many importname values contain only a PR family and the code (REI:H3B, SIB:N3Q), or
the word Unknown. Some rows have a name of only M, the PR family and the code, such as
MTKV4K7 for 4K7 on the 2026 A5.
specialGroups["ECL-exclusive-exterior"] holds the Audi exclusive paint program, which
some US models have. It is the only group the US catalog returns in German. Its colors have
German importname values, such as Nachtblau Perleffekt, and most also have a German
ak_headline. No other category has German text.