{
  "info": {
    "_postman_id": "vw-us-collection-v1",
    "name": "Public OEM APIs / Volkswagen / US",
    "description": "VW US public API collection covering MOFA current model overview, OneAPI configurator features, GSL inventory search, and DCC dealers. Auto-exported fallback — Postman MCP OAuth was unavailable; import manually into the team workspace.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "cacheKey",
      "value": "89b5b19699de0fc7981a6d270c6bd4795202b0b7",
      "type": "string",
      "description": "OneAPI Victor cache key — refresh via GET /cks/cachekey/ihdcc-vw-us-en before configStart calls"
    },
    {
      "key": "carlineKey",
      "value": "31691",
      "type": "string",
      "description": "Example: 31691 = Atlas"
    },
    {
      "key": "salesgroupKey",
      "value": "34910",
      "type": "string",
      "description": "Example: 34910 = Atlas SE trim salesgroup from MOFA model overview"
    },
    {
      "key": "modelKey",
      "value": "CA33PZ",
      "type": "string",
      "description": "Trim model code — e.g. CA33PZ = Atlas SE"
    },
    {
      "key": "trimName",
      "value": "SE",
      "type": "string",
      "description": "Trim display name"
    },
    {
      "key": "page",
      "value": "1",
      "type": "string",
      "description": "GSL page number (1-based). Include pageitems=12; API reports actual page size in meta.pageItems."
    },
    {
      "key": "oneapiKey",
      "value": "nOqkwPxxu8ViK9aaHvTkglzVZAlX4yIx",
      "type": "string",
      "description": "GSL oneapiKey — embedded in the dataVersion-coupled request"
    },
    {
      "key": "dataVersion",
      "value": "CBB8D5AC8A6F69F5DD4EEC026D747E87",
      "type": "string",
      "description": "GSL dataVersion from en.global-config.json spaAsyncConfig.dataVersions.serviceConfigsVersion. Do not hardcode in pipeline code."
    },
    {
      "key": "endpoint",
      "value": "{\"endpoint\":{\"type\":\"publish\",\"country\":\"us\",\"language\":\"en\",\"content\":\"onehub_pkw\",\"envName\":\"prod\",\"testScenarioId\":null},\"signature\":\"VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI=\"}",
      "type": "string",
      "description": "GSL/DCC endpoint config JSON — URL-encoded in actual requests"
    },
    {
      "key": "lufthansaApiKey",
      "value": "h0CQWvPYSBvp5KYXUpRU4FpZrnl0tZx1",
      "type": "string",
      "description": "DCC API key (Lufthansa-style key param)"
    },
    {
      "key": "dccQuery",
      "value": "{\"type\":\"DEALER\",\"language\":\"en-US\",\"countryCode\":\"US\",\"dealerServiceFilter\":[],\"contentDealerServiceFilter\":[],\"usePrimaryTenant\":true,\"name\":\" \"}",
      "type": "string",
      "description": "DCC dealer search query JSON — URL-encoded in actual requests"
    },
    {
      "key": "modelYear",
      "value": "2026",
      "type": "string",
      "description": "Model year from MOFA model overview; required by configStart for current US models"
    },
    {
      "key": "mofaCacheBuster",
      "value": "3",
      "type": "string",
      "description": "MOFA cacheBuster/modelCacheBuster from https://www.vw.com/en.global-config.json"
    },
    {
      "key": "mofaDataVersion",
      "value": "3-CBB8D5AC8A6F69F5DD4EEC026D747E87-B86D13719C8CD4AFE83B9E5BB1FC29B5-3754F07404B85EBCEA3E52514E263065",
      "type": "string",
      "description": "MOFA dataVersion: cacheBuster-serviceConfigsVersion-modelStructureVersion-mofaCarDataVersion"
    },
    {
      "key": "mofaServiceConfigEndpointToken",
      "value": "{\"endpoint\":{\"type\":\"publish\",\"country\":\"us\",\"language\":\"en\",\"content\":\"onehub_pkw\",\"envName\":\"prod\",\"testScenarioId\":null},\"signature\":\"VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI=\"}",
      "type": "string",
      "description": "MOFA serviceConfigEndpoint token from en.global-config.json"
    },
    {
      "key": "mofaOneApiKey",
      "value": "1AvAgztRZs6LdqjOULN1u7WTskbc5AnS",
      "type": "string",
      "description": "MOFA model-overview oneapiKey from VW Feature Hub manifest"
    },
    {
      "key": "gslBaseUrl",
      "value": "https://v3-116-1.gsl.feature-app.io",
      "type": "string",
      "description": "GSL feature-app base URL resolved from https://www.vw.com/en.global-config.json; update from global config, not by hand in code."
    }
  ],
  "item": [
    {
      "name": "VW OneAPI — Cache Key",
      "description": "Fetches the current cache key required by all subsequent OneAPI calls. Must be called first in each pipeline run. Cache key is a SHA1 hash of the current catalog state.",
      "item": [
        {
          "name": "Get Cache Key (concrete)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "1AvAgztRZs6LdqjOULN1u7WTskbc5AnS",
                "type": "text",
                "description": "OneAPI key for catalog/models endpoints"
              }
            ],
            "url": {
              "raw": "https://oneapi.volkswagen.com/cks/cachekey/ihdcc-vw-us-en",
              "protocol": "https",
              "host": [
                "oneapi",
                "volkswagen",
                "com"
              ],
              "path": [
                "cks",
                "cachekey",
                "ihdcc-vw-us-en"
              ]
            },
            "description": "Returns JSON with a key field. Store key as {{cacheKey}} for subsequent /vcso/configStart requests. Re-fetch before each pipeline run."
          },
          "response": []
        }
      ]
    },
    {
      "name": "MOFA — Current Models (Builder Model Overview)",
      "description": "Current VW US builder model/trim enumerator. Replaces the stale OneAPI /viso/catalogue US tenant for product data.",
      "item": [
        {
          "name": "Get Current Model Overview (concrete)",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Concrete request captured from vw.com/en/builder.html on 2026-06-17; returns MY2026 models/trims.",
            "url": {
              "raw": "https://v1-548-2.mofa.feature-app.io/bff/model-overview?cacheBuster=3&countryCode=US&currency=USD&dataVersion=CBB8D5AC8A6F69F5DD4EEC026D747E87-B86D13719C8CD4AFE83B9E5BB1FC29B5-3754F07404B85EBCEA3E52514E263065&enableTracing=true&featureFlags=&language=en&mode=standalone&oneapiKey=1AvAgztRZs6LdqjOULN1u7WTskbc5AnS&serviceConfigEndpointToken=%7B%22endpoint%22%3A%7B%22type%22%3A%22publish%22%2C%22country%22%3A%22us%22%2C%22language%22%3A%22en%22%2C%22content%22%3A%22onehub_pkw%22%2C%22envName%22%3A%22prod%22%2C%22testScenarioId%22%3Anull%7D%2C%22signature%22%3A%22VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI%3D%22%7D&ssr=true",
              "protocol": "https",
              "host": [
                "v1-548-2",
                "mofa",
                "feature-app",
                "io"
              ],
              "path": [
                "bff",
                "model-overview"
              ],
              "query": [
                {
                  "key": "cacheBuster",
                  "value": "3"
                },
                {
                  "key": "countryCode",
                  "value": "US"
                },
                {
                  "key": "currency",
                  "value": "USD"
                },
                {
                  "key": "dataVersion",
                  "value": "CBB8D5AC8A6F69F5DD4EEC026D747E87-B86D13719C8CD4AFE83B9E5BB1FC29B5-3754F07404B85EBCEA3E52514E263065"
                },
                {
                  "key": "enableTracing",
                  "value": "true"
                },
                {
                  "key": "featureFlags",
                  "value": ""
                },
                {
                  "key": "language",
                  "value": "en"
                },
                {
                  "key": "mode",
                  "value": "standalone"
                },
                {
                  "key": "oneapiKey",
                  "value": "1AvAgztRZs6LdqjOULN1u7WTskbc5AnS"
                },
                {
                  "key": "serviceConfigEndpointToken",
                  "value": "{\"endpoint\":{\"type\":\"publish\",\"country\":\"us\",\"language\":\"en\",\"content\":\"onehub_pkw\",\"envName\":\"prod\",\"testScenarioId\":null},\"signature\":\"VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI=\"}"
                },
                {
                  "key": "ssr",
                  "value": "true"
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Get Current Model Overview (parameterized)",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Parameterized current model overview request. Refresh mofaDataVersion and token from en.global-config.json.",
            "url": {
              "raw": "https://v1-548-2.mofa.feature-app.io/bff/model-overview?cacheBuster={{mofaCacheBuster}}&countryCode=US&currency=USD&dataVersion={{mofaDataVersion}}&enableTracing=true&featureFlags=&language=en&mode=standalone&oneapiKey={{mofaOneApiKey}}&serviceConfigEndpointToken={{mofaServiceConfigEndpointToken}}&ssr=true",
              "protocol": "https",
              "host": [
                "v1-548-2",
                "mofa",
                "feature-app",
                "io"
              ],
              "path": [
                "bff",
                "model-overview"
              ],
              "query": [
                {
                  "key": "cacheBuster",
                  "value": "{{mofaCacheBuster}}"
                },
                {
                  "key": "countryCode",
                  "value": "US"
                },
                {
                  "key": "currency",
                  "value": "USD"
                },
                {
                  "key": "dataVersion",
                  "value": "{{mofaDataVersion}}"
                },
                {
                  "key": "enableTracing",
                  "value": "true"
                },
                {
                  "key": "featureFlags",
                  "value": ""
                },
                {
                  "key": "language",
                  "value": "en"
                },
                {
                  "key": "mode",
                  "value": "standalone"
                },
                {
                  "key": "oneapiKey",
                  "value": "{{mofaOneApiKey}}"
                },
                {
                  "key": "serviceConfigEndpointToken",
                  "value": "{{mofaServiceConfigEndpointToken}}"
                },
                {
                  "key": "ssr",
                  "value": "true"
                }
              ]
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "VW OneAPI — Features (vcso/configStart)",
      "description": "Full configurator feature catalogue. Use modelKey/modelYear/carline/salesgroup/trim from the current MOFA model overview.",
      "item": [
        {
          "name": "Get Features — Atlas SE CA33PZ (concrete)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "Ox5AegtsLDecFmKHxYdf599VKBCpHsX4",
                "type": "text",
                "description": "Configurator API key — different from the catalog key"
              }
            ],
            "url": {
              "raw": "https://oneapi.volkswagen.com/vcso/configStart?modelKey=CA33PZ&carlineKey=31691&salesgroupKey=34910&trimName=SE&tenant=ihdcc-vw-us-en&cacheKey={{cacheKey}}&modelYear=2026",
              "protocol": "https",
              "host": [
                "oneapi",
                "volkswagen",
                "com"
              ],
              "path": [
                "vcso",
                "configStart"
              ],
              "query": [
                {
                  "key": "modelKey",
                  "value": "CA33PZ"
                },
                {
                  "key": "carlineKey",
                  "value": "31691"
                },
                {
                  "key": "salesgroupKey",
                  "value": "34910"
                },
                {
                  "key": "trimName",
                  "value": "SE"
                },
                {
                  "key": "tenant",
                  "value": "ihdcc-vw-us-en"
                },
                {
                  "key": "cacheKey",
                  "value": "{{cacheKey}}"
                },
                {
                  "key": "modelYear",
                  "value": "2026"
                }
              ]
            },
            "description": "Requires current MOFA model identifiers, including modelYear, plus a live Victor cacheKey."
          },
          "response": []
        },
        {
          "name": "Get Features (parameterized)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "Ox5AegtsLDecFmKHxYdf599VKBCpHsX4",
                "type": "text"
              }
            ],
            "url": {
              "raw": "https://oneapi.volkswagen.com/vcso/configStart?modelKey={{modelKey}}&carlineKey={{carlineKey}}&salesgroupKey={{salesgroupKey}}&trimName={{trimName}}&tenant=ihdcc-vw-us-en&cacheKey={{cacheKey}}&modelYear={{modelYear}}",
              "protocol": "https",
              "host": [
                "oneapi",
                "volkswagen",
                "com"
              ],
              "path": [
                "vcso",
                "configStart"
              ],
              "query": [
                {
                  "key": "modelKey",
                  "value": "{{modelKey}}"
                },
                {
                  "key": "carlineKey",
                  "value": "{{carlineKey}}"
                },
                {
                  "key": "salesgroupKey",
                  "value": "{{salesgroupKey}}"
                },
                {
                  "key": "trimName",
                  "value": "{{trimName}}"
                },
                {
                  "key": "tenant",
                  "value": "ihdcc-vw-us-en"
                },
                {
                  "key": "cacheKey",
                  "value": "{{cacheKey}}"
                },
                {
                  "key": "modelYear",
                  "value": "{{modelYear}}"
                }
              ]
            },
            "description": "Requires current MOFA model identifiers, including modelYear, plus a live Victor cacheKey."
          },
          "response": []
        }
      ]
    },
    {
      "name": "GSL — Inventory Search",
      "description": "GSL VIN inventory search. Omit t_model: the brand-level t_cartype=N request returns all new VW US inventory with coherent pageMax pagination.",
      "item": [
        {
          "name": "Search Inventory — brand page 1 (concrete)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://v3-116-1.gsl.feature-app.io/bff/car/search?t_cartype=N&sort=PRICE_SALE&sortdirection=ASC&pageitems=12&page=1&country=US&language=en&market=passenger&oneapiKey=nOqkwPxxu8ViK9aaHvTkglzVZAlX4yIx&dataVersion=CBB8D5AC8A6F69F5DD4EEC026D747E87&endpoint=%7B%22endpoint%22%3A%7B%22type%22%3A%22publish%22%2C%22country%22%3A%22us%22%2C%22language%22%3A%22en%22%2C%22content%22%3A%22onehub_pkw%22%2C%22envName%22%3A%22prod%22%2C%22testScenarioId%22%3Anull%7D%2C%22signature%22%3A%22VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI%3D%22%7D",
              "protocol": "https",
              "host": [
                "v3-116-1",
                "gsl",
                "feature-app",
                "io"
              ],
              "path": [
                "bff",
                "car",
                "search"
              ],
              "query": [
                {
                  "key": "t_cartype",
                  "value": "N"
                },
                {
                  "key": "sort",
                  "value": "PRICE_SALE"
                },
                {
                  "key": "sortdirection",
                  "value": "ASC"
                },
                {
                  "key": "pageitems",
                  "value": "12"
                },
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "country",
                  "value": "US"
                },
                {
                  "key": "language",
                  "value": "en"
                },
                {
                  "key": "market",
                  "value": "passenger"
                },
                {
                  "key": "oneapiKey",
                  "value": "nOqkwPxxu8ViK9aaHvTkglzVZAlX4yIx"
                },
                {
                  "key": "dataVersion",
                  "value": "CBB8D5AC8A6F69F5DD4EEC026D747E87"
                },
                {
                  "key": "endpoint",
                  "value": "{\"endpoint\":{\"type\":\"publish\",\"country\":\"us\",\"language\":\"en\",\"content\":\"onehub_pkw\",\"envName\":\"prod\",\"testScenarioId\":null},\"signature\":\"VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI=\"}"
                }
              ]
            },
            "description": "Concrete brand-level VW new inventory page 1 request. No t_model filter; pageitems hard-capped at 12. Verified live 2026-06-24: meta.resultNumber=68672, meta.pageMax=5723; page 2 disjoint from page 1; final page 5723 returned 8 cars (= 68672-(5723-1)*12). Completeness certified on t_model=BQAM: 1839/1839 across 154 pages."
          },
          "response": []
        },
        {
          "name": "Search Inventory (parameterized)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{gslBaseUrl}}/bff/car/search?t_cartype=N&sort=PRICE_SALE&sortdirection=ASC&pageitems=12&page={{page}}&country=US&language=en&market=passenger&oneapiKey={{oneapiKey}}&dataVersion={{dataVersion}}&endpoint={{endpoint}}",
              "protocol": "https",
              "host": [
                "v3-116-1",
                "gsl",
                "feature-app",
                "io"
              ],
              "path": [
                "bff",
                "car",
                "search"
              ],
              "query": [
                {
                  "key": "t_cartype",
                  "value": "N"
                },
                {
                  "key": "sort",
                  "value": "PRICE_SALE"
                },
                {
                  "key": "sortdirection",
                  "value": "ASC"
                },
                {
                  "key": "pageitems",
                  "value": "12"
                },
                {
                  "key": "page",
                  "value": "{{page}}"
                },
                {
                  "key": "country",
                  "value": "US"
                },
                {
                  "key": "language",
                  "value": "en"
                },
                {
                  "key": "market",
                  "value": "passenger"
                },
                {
                  "key": "oneapiKey",
                  "value": "{{oneapiKey}}"
                },
                {
                  "key": "dataVersion",
                  "value": "{{dataVersion}}"
                },
                {
                  "key": "endpoint",
                  "value": "{{endpoint}}"
                }
              ]
            },
            "description": "Parameterized brand-level inventory search. Omit t_model to collect all new VW US inventory; iterate page until meta.pageMax or a short final page."
          },
          "response": []
        }
      ]
    },
    {
      "name": "DCC — Dealers",
      "description": "Dealer Configuration Center (DCC) dealer search. Returns all 626 US VW dealers (live 2026-06-24) in a single national call — no pagination or enumeration needed.",
      "item": [
        {
          "name": "Get All US Dealers (concrete)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://v3-81-1.ds-us.dcc.feature-app.io/bff-search/dealers?lufthansaApiKey=h0CQWvPYSBvp5KYXUpRU4FpZrnl0tZx1&serviceConfigEndpoint=%7B%22endpoint%22%3A%7B%22type%22%3A%22publish%22%2C%22country%22%3A%22us%22%2C%22language%22%3A%22en%22%2C%22content%22%3A%22onehub_pkw%22%2C%22envName%22%3A%22prod%22%2C%22testScenarioId%22%3Anull%7D%2C%22signature%22%3A%22VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI%3D%22%7D&query=%7B%22type%22%3A%22DEALER%22%2C%22language%22%3A%22en-US%22%2C%22countryCode%22%3A%22US%22%2C%22dealerServiceFilter%22%3A%5B%5D%2C%22contentDealerServiceFilter%22%3A%5B%5D%2C%22usePrimaryTenant%22%3Atrue%2C%22name%22%3A%22+%22%7D",
              "protocol": "https",
              "host": [
                "v3-81-1",
                "ds-us",
                "dcc",
                "feature-app",
                "io"
              ],
              "path": [
                "bff-search",
                "dealers"
              ],
              "query": [
                {
                  "key": "lufthansaApiKey",
                  "value": "h0CQWvPYSBvp5KYXUpRU4FpZrnl0tZx1"
                },
                {
                  "key": "serviceConfigEndpoint",
                  "value": "{\"endpoint\":{\"type\":\"publish\",\"country\":\"us\",\"language\":\"en\",\"content\":\"onehub_pkw\",\"envName\":\"prod\",\"testScenarioId\":null},\"signature\":\"VehBWLTr2hxx8TJ85NJrpgRXoPfAyNcz2K8KuyXQTNI=\"}"
                },
                {
                  "key": "query",
                  "value": "{\"type\":\"DEALER\",\"language\":\"en-US\",\"countryCode\":\"US\",\"dealerServiceFilter\":[],\"contentDealerServiceFilter\":[],\"usePrimaryTenant\":true,\"name\":\" \"}"
                }
              ]
            },
            "description": "Returns all 626 US VW dealers (live 2026-06-24). Response: {dealers: [...]}. dealers[].id (e.g. '06457') is the FK target. Inventory joins via cars[].dealer.key = 'USA' + dealers[].id (strip 'USA' prefix from inventory side; USA06457 -> 06457, 12/12 resolved live). dealers[].coordinates = [lat, lon]."
          },
          "response": []
        },
        {
          "name": "Get All US Dealers (parameterized)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://v3-81-1.ds-us.dcc.feature-app.io/bff-search/dealers?lufthansaApiKey={{lufthansaApiKey}}&serviceConfigEndpoint={{endpoint}}&query={{dccQuery}}",
              "protocol": "https",
              "host": [
                "v3-81-1",
                "ds-us",
                "dcc",
                "feature-app",
                "io"
              ],
              "path": [
                "bff-search",
                "dealers"
              ],
              "query": [
                {
                  "key": "lufthansaApiKey",
                  "value": "{{lufthansaApiKey}}"
                },
                {
                  "key": "serviceConfigEndpoint",
                  "value": "{{endpoint}}"
                },
                {
                  "key": "query",
                  "value": "{{dccQuery}}"
                }
              ]
            },
            "description": "Parameterized. Single call — no iteration needed. serviceConfigEndpoint and endpoint share the same JSON blob."
          },
          "response": []
        }
      ]
    }
  ]
}