Skip to main content

NetDirector Source

JLR inventory data retrieved from the ATG NetDirector GraphQL API (getAll query). Covers new and used vehicle listings per dealership for both Land Rover and Jaguar.

Endpoint​

POST https://production-api-oregon.search-api.netdirector.auto/api/vehicle-search

Auth: static authorization header + brand-specific uuid query parameter. No WAF.

Dual-brand coverage​

Each brand has its own UUID:

BrandUUIDApproximate volume (new)Approximate volume (used)
Land Rover129ab960-5b4e-11ed-bb64-ed0ed6312d26~27k~6k
Jaguarcbb79950-5b4d-11ed-bb64-ed0ed6312d26~1.3k~633

Dealer code transformation (Jaguar)​

The retailerlocator API returns Jaguar dealer codes with a leading 0 (e.g. 05806), but NetDirector expects a J prefix (e.g. J5806). The transformation 0XXXX → JXXXX is applied in two places:

  1. dealer_codes_from_upstream — when building the per-dealer fetch list from retailerlocator raw data, Jaguar codes are transformed before querying NetDirector.
  2. extract_dealers (retailerlocator) — the transformed code is saved as dealer_code and the original is preserved as raw_dealer_code.

Without this transformation, Jaguar inventory is silently missing — NetDirector returns empty results for 0-prefixed codes.

Brand population​

brand is set on each inventory record from the request context. The brand slug from the fetch context (e.g. "land_rover", "jaguar") is mapped to display form ("Land Rover", "Jaguar") via _BRAND_DISPLAY.

Pagination​

Per-dealer queries with currentPage=1, pageSize=5000. The API silently truncates getAll at ~10,000 records for any single query. Segmenting by dealer code keeps every query well below this ceiling (largest dealer has ~650 vehicles).

Known data quality issues​

shipping_status — unverified categorical flag with unknown enumeration​

Observed: jlr/us/transformed/netdirector_new_inventory, 7 entities with distinct value combinations

shipping_status is sourced from the GraphQL field shippingStatus. It appears alongside status, isFeatured, and isExDemo, suggesting it represents where a vehicle is in the OEM-to-dealer logistics chain (e.g. in-transit, arrived, allocated). The enumerated values are not documented in any publicly accessible NetDirector or JLR API reference.

manufacturer — null for ~40% of Land Rover vehicles​

The manufacturer field in NetDirector responses is null for a significant portion of Land Rover vehicles. The pipeline does not filter by manufacturer — it uses condition only.