Skip to main content

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:

TierAssetsMarkets
Fulldealers, carlines, catalog features, inventoryar, 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:

TierAvailable API dataDisabled markets
No inventorydealers, carlines, catalog featuresbe, dk, fi, in, th, tr
Dealers onlydealersat, 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: USED or NEW.

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​

DomainUsed for
omnigraph.audi.comInventory (StockCarSearch) and model structure (CarlineStructure)
graphql.pss.audi.comDealer locator
web-api.audi.comFeature and option catalog per model

Raw dependency graph​

NodeRaw assetUpstreamSource
aaudi/us/raw/onegraph_modelsnoneOmniGraph CarlineStructure
baudi/us/raw/catalog_featuresaWeb-API CatalogForModel per model_id
caudi/us/raw/onegraph_inventorynoneOmniGraph StockCarSearch
daudi/us/raw/pss_dealersnonePSS dealersByMarket

OmniGraph GraphQL API​

POST https://omnigraph.audi.com/graphql
Client-header deny-list

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:

HeaderInventoryCarlineStructure
apollographql-client-nameaudi-data-platformaudi-data-platform
apollographql-client-version1.0.01.0.0
content-typeapplication/jsonapplication/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_PREDATEEND and DATE_OFFER, and default to DATE_OFFER.
  • The US accepts STAT_GWPLUS but sorts by DISTANCE instead.

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:

ViewTransparentTransparent wideWith background
Frontsc4c03sc3c03vtp4x3n3c
3/4 frontsc4c01 (small: sc5c01)nonevtp4x3n1c
Zoom 3/4 front hoodsc4c02nonevtp4x3n2c
Zoom 3/4 front bumpernonesc3c02none
Sidesc4c14sc3c14vtp4x3n8c
3/4 rearsc4c12sc3c12vtp4x3n6c
Rearsc4c11sc3c11vtp4x3n5c
Interior, rear-facing angledsc4n05sc3n05vtp4x3i1n
Interior, front-facing near-straightsc4n06sc3n06vtp4x3i2n

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 WPS are absent from cdbCategories on every model, whether the package is the trim default or a paid second tier. The configuredCar query'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 inventory stockCar.features includes package codes.
  • Many SERIES features are also absent from cdb. It is a curated display list and does not list all standard equipment.
  • CA and DE return manufacturerSpecificItems with 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:

FieldDescription
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.modelyearModel year, the same as model.salesModelyear
stockCar.qualityLabel { label }Quality label, such as Certified Pre-Owned
stockCar.cartypeTextCar type text
stockCar.preUse { code text }Pre-use classification
stockCar.descriptionByDealerFree-text dealer description
stockCar.colorInfo.*.imageUrlSwatch 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/selectedItemsFacet 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:

  • programName
  • offerType
  • creditBonus
  • aprRate
  • term
  • monthlyPayment
  • totalDueAtSign
  • customerDownPayment
  • programFromDate and programToDate, as YYYYMMDD
  • region
  • zipClusterID
  • offerDisclaimer
  • offerModelDetail, with the model code, model year, family, trimline and MSRP
  • stackableOffers

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_SPEND and AUD_LEASE_SUBVENTION_SPEND

  • offerType: credit, finance and lease

  • region: USA, and the region codes ANE, ASE, AUC, AUW, CA, FL, GA and TX

  • Location. zipCode is a five-digit ZIP. The server maps it to a pricing cluster and returns that cluster in zipClusterID, such as New England Area(285). An offer priced the same everywhere has region USA. In some ZIPs, the zipClusterID of such an offer is the cluster name, and in others it is USA. 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. Every asOfDate from one offer period's programFromDate to its programToDate returns the same response. The last day of May and of July 2026 returns every row twice. An asOfDate after the current offer period returns no offers. offerMonth (YYYYMM) returns the asOfDate response for the 5th of that month.

  • Coverage. No response from 2026-04-22 to 2026-10-21 has a MY2027 offer. Vehicles' REBATE1 credits 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-null msrp).
  • 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, name adds the trim's color names.
  • On some package-content rows, name matches 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.