AutoPartsAPI Documentation
Complete reference for the TecDoc 2025 Q3 REST API — vehicles, parts, OEM numbers, cross-references, media, and VIN decoding. All endpoints authenticated via x-apiprofile-key.
Authentication
Every request must include the header x-apiprofile-key: <your-key>. The server stores only a SHA-256 hash of your key — the raw value is never persisted. Obtain your key from Console → Developer Settings.
curl --request GET \ --url https://api.autopartsapi.com/api/languages/list \ --header 'x-apiprofile-key: apk_your_key_here'
Common Parameters
Several parameters appear across most endpoints. Resolve them once and cache them — the values change only when the dataset is updated.
| Parameter | Type | Description | Values |
|---|---|---|---|
typeId |
int | Vehicle category selector | 1 = Passenger Car · 2 = Commercial Vehicle · 3 = Motorbike |
langId |
int | Language for localised labels | Use GET /api/languages/list. Common: 4 = English, 1 = German, 19 = French |
countryFilterId |
int | Country/market filter | Use GET /api/countries/list. 63 = Germany (global default) |
manufacturerId |
int | TecDoc manufacturer ID | Use GET /api/manufacturers/list/type-id/{typeId} |
modelId |
int | Model series ID | Use GET /api/models/list/… |
vehicleId |
int | Specific vehicle type ID within a model series | Use GET /api/types/type-id/{t}/list-vehicles-id/{modelId}/… |
Rate Limits & Quotas
Limits are enforced at two levels simultaneously.
| Limit type | Enforced by | When exceeded |
|---|---|---|
| RPS (requests per second) | Redis fixed-window counter per subscription | 429 Too Many Requests — back off and retry |
| Monthly quota | Usage cycle counter (resets on renewal date) | 403 Forbidden — upgrade plan or enable auto-renew in Console |
Error Codes
All error responses return JSON with a message field.
| Status | Meaning | Common cause |
|---|---|---|
| 200 | OK | Successful response |
| 400 | Bad Request | Invalid parameter type (e.g. non-integer manufacturerId) |
| 401 | Unauthorised | Missing or unrecognised x-apiprofile-key |
| 403 | Forbidden | Subscription inactive, suspended, or monthly quota exhausted |
| 404 | Not Found | Route not found, or query returned no results |
| 429 | Too Many Requests | RPS rate limit exceeded — reduce request rate and retry |
| 500 | Internal Server Error | Unexpected server error — contact support if recurring |
Quick Start
Minimal working example: list brake pads compatible with a BMW 3-Series diesel.
Verify your key works
Call the language list — no parameters required. A 200 response confirms your key is valid.
curl -X GET 'https://api.autopartsapi.com/api/languages/list' \ -H 'x-apiprofile-key: apk_your_key'
List passenger-car manufacturers
typeId=1 for Passenger Cars. Find BMW in the response — note its manuId (commonly 16).
curl -X GET 'https://api.autopartsapi.com/api/manufacturers/list/type-id/1' \ -H 'x-apiprofile-key: apk_your_key'
Get model series for BMW
Use langId=4 (English), countryFilterId=63 (Germany), and BMW's manufacturerId.
curl -X GET 'https://api.autopartsapi.com/api/models/list/type-id/1/manufacturer-id/16/lang-id/4/country-filter-id/63' \ -H 'x-apiprofile-key: apk_your_key'
List vehicles in the 3-Series model
Pick a modelId from step 3 (e.g. 5626 = 3-Series). This returns individual engine variants — pick a vehicleId.
curl -X GET 'https://api.autopartsapi.com/api/types/type-id/1/list-vehicles-id/5626/lang-id/4/country-filter-id/63' \ -H 'x-apiprofile-key: apk_your_key'
Get part categories for the vehicle
Use vehicleId=19942 from step 4. Variant 2 returns a nested tree — find "Braking System" and note its deepest categoryId.
curl -X GET 'https://api.autopartsapi.com/api/category/type-id/1/products-groups-variant-2/19942/lang-id/4' \ -H 'x-apiprofile-key: apk_your_key'
Fetch articles for the vehicle + category
Pass the vehicleId and a categoryId (e.g. 100260). The response includes part numbers, supplier info, and CDN image URLs.
curl -X GET 'https://api.autopartsapi.com/api/articles/list/type-id/1/vehicle-id/19942/category-id/100260/lang-id/4' \ -H 'x-apiprofile-key: apk_your_key'
Standard Lookup Workflow
Every vehicle-to-parts lookup follows this linear chain. Cache each resolved ID to avoid repeating lookups.
Languages →
Countries →
Manufacturers (typeId) →
Model Series →
Vehicle List →
Categories →
Articles →
Article Details / Media / Specs
Base URL & Versioning
All endpoints share the same base URL. The path prefix /api/ denotes version 2.
No version segment appears in the URL — version 2 is the default and current stable release. Path parameters follow the pattern /param-name/{paramValue} (e.g. /type-id/1/lang-id/4).
Article Number Types
Several cross-reference endpoints accept an articleType parameter. Valid string values:
| Value | Meaning |
|---|---|
ArticleNumber | Supplier's own part number (aftermarket) |
IAMNumber | Independent aftermarket number |
EAN | EAN-13 / barcode |
OENumber | Original equipment (OEM) number |
TradeNumber | Trade / generic catalog number |
API Reference
Click any group to expand. Click any endpoint to see its parameters.
Languages
Language endpoints 2 endpoints
GET /api/languages/list All supported languages API-GLNG-001
Returns every language available in the TecDoc dataset. Use the returned langId in all subsequent requests that accept a language parameter.
No parameters required.
GET /api/languages/get-language/lang-id/{langId} Single language by ID API-GLNG-002
Fetch details for a specific language.
| Parameter | Type | Required |
|---|---|---|
langId | int | Required |
Countries
Country endpoints 3 endpoints
GET /api/countries/list All countries (default language) API-GCO-001
Returns all countries. No parameters required. Use countryFilterId = 63 (Germany) as a safe default for worldwide coverage.
GET /api/countries/list-countries-by-lang-id/{langId} Countries with localised names API-GCO-002
| Parameter | Type | Required |
|---|---|---|
langId | int | Required |
GET /api/countries/get-country/lang-id/{langId}/country-filter-id/{countryFilterId} Single country by ID API-GCO-003
| Parameter | Type | Required |
|---|---|---|
langId | int | Required |
countryFilterId | int | Required |
Vehicle Types
1 Passenger Car · 2 Commercial Vehicle · 3 Motorbike. All vehicle-type endpoints respect this selector.
Vehicle type endpoints 7 endpoints
GET /api/types/list-vehicles-type All supported typeId values API-GTYP-001
Returns the static list of vehicle category types (PC, CV, Motorbike, etc.) with their numeric IDs. No parameters.
GET /api/types/type-id/{typeId}/list-vehicles-id/{modelId}/lang-id/{langId}/country-filter-id/{countryFilterId} Vehicle IDs for a model series API-GTYP-002
Returns vehicle variants within a model series with minimal info (ID + name). Use this to pick a vehicleId for part lookups.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
modelId | int | Optional | 5626 |
langId | int | Optional | 4 |
countryFilterId | int | Optional | 63 |
GET /api/types/type-id/{typeId}/list-vehicles-types/{modelId}/lang-id/{langId}/country-filter-id/{countryFilterId} Vehicle variants with engine specs API-GTYP-003
Same as API-GTYP-002 but returns full engine specification data (kW, CC, cylinders, engine codes) for each variant.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
modelId | int | Optional | 5626 |
langId | int | Optional | 4 |
countryFilterId | int | Optional | 63 |
GET /api/types/type-id/{typeId}/vehicle-type-details/{vehicleId}/lang-id/{langId}/country-filter-id/{countryFilterId} Full vehicle specification API-GTYP-004
Returns complete technical details for a single vehicle: make, model, engine, power output (kW/HP), displacement, valves, cylinders, fuel type, production years, KBA numbers.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
vehicleId | int | Optional | 19942 |
langId | int | Optional | 4 |
countryFilterId | int | Optional | 63 |
GET /api/types/searching-the-passenger-car-by-ltn-number/lang-id/{langId}/country-filter-id/{countryFilterId}/ltn-number/{ltnNumber}/number-type/{ltnNumberType} Search vehicle by KBA / licence plate API-GTYP-005
Searches passenger cars by registration-system numbers. Supported ltnNumberType values: 1 = German KBA number, 2 = Netherlands Kenteken, 3 = French Typemine, 4 = Engine Code, 5 = CV Manufacturer Number.
| Parameter | Type | Required | Example |
|---|---|---|---|
langId | int | Required | 1 |
countryFilterId | int | Optional | 63 |
ltnNumber | string | Optional | 2VXT04 |
ltnNumberType | int | Optional | 2 |
GET /api/types/selecting-all-criteria-for-spare-parts-of-a-passenger-car-using-an-olap-query/type-id/{typeId}/lang-id/{langId}/country-filter-id/{countryFilterId}/vehicle-id/{vehicleId} OLAP criteria for all compatible parts API-GTYP-006
Returns all fitment criteria for spare parts of the given vehicle. Useful for building advanced filtering UIs showing which criteria distinguish parts.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
langId | int | Required | 4 |
countryFilterId | int | Required | 63 |
vehicleId | int | Required | 19942 |
GET /api/types/get-typeid-by-vehicleid?vehicleId=&manufacturerId= Resolve typeId from a vehicleId API-GTYP-007
Pass a vehicleId and manufacturerId as query-string parameters. Returns the matching typeId (PC / CV / Motorbike) without needing to know the vehicle category in advance. Useful when you receive a raw vehicle ID from an external system.
| Parameter | Type | Location | Required |
|---|---|---|---|
vehicleId | int | query string | Required |
manufacturerId | int | query string | Optional |
Manufacturers
Manufacturer endpoints 3 endpoints
GET /api/manufacturers/list/type-id/{typeId} All manufacturers for a vehicle type API-GMFA-001
Returns all vehicle manufacturers available for the given typeId, along with their TecDoc manuId. Response includes a countManufactures field.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
GET /api/manufacturers/find-by-id/{manufacturerId} Single manufacturer + logo URL API-GMFA-002
Returns manufacturer details plus a CDN URL for the brand logo image (.png).
| Parameter | Type | Required | Example |
|---|---|---|---|
manufacturerId | int | Required | 184 |
GET /api/manufacturers/get-manufacturer-types/{manufacturerId} Vehicle types produced by a manufacturer API-GMFA-003
Returns which vehicle types (PC / CV / Motorbike) this manufacturer produces within the TecDoc dataset.
| Parameter | Type | Required | Example |
|---|---|---|---|
manufacturerId | int | Required | 184 |
Model Series
Model series endpoints 4 endpoints
GET /api/models/list/type-id/{typeId}/manufacturer-id/{manufacturerId}/lang-id/{langId}/country-filter-id/{countryFilterId} All model series for a manufacturer API-GMDS-001
Returns the model series (e.g. "3-Series", "Golf", "Transit") for a given manufacturer and vehicle type. Response includes countModels and a models array.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
manufacturerId | int | Optional | 5 |
langId | int | Optional | 4 |
countryFilterId | int | Optional | 63 |
GET /api/models/type-id/{typeId}/model-id/{modelId}/lang-id/{langId}/country-filter-id/{countryFilterId} Single model series name & details API-GMDS-002
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
modelId | int | Optional | 5626 |
langId | int | Optional | 4 |
countryFilterId | int | Optional | 63 |
GET /api/models/type-id/{typeId}/vehicles/{vehicleId}/lang-id/{langId}/country-filter-id/{countryFilterId} Model series name for a specific vehicle API-GMDS-003
Resolves the model series name when you already have a vehicleId — the API handles PC/CV/Motorbike routing internally.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
vehicleId | int | Optional | 19942 |
langId | int | Optional | 4 |
countryFilterId | int | Optional | 63 |
GET /api/models/type-id/{typeId}/model-id/{modelId} Model photo CDN URL API-GMDS-004
Returns a CDN URL for the model series photo (modelImage). Available for Passenger Cars only; returns null for CV and Motorbikes.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
modelId | int | Optional | 5626 |
Categories (Product Groups)
API-GCA-004) to get only the deepest node IDs needed for the articles call.
Category endpoints 7 endpoints
GET /api/category/type-id/{typeId}/products-groups-variant-1/{vehicleId}/lang-id/{langId} Category tree — flat list with depth API-GCA-001
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
vehicleId | int | Required | 19942 |
langId | int | Required | 4 |
GET /api/category/type-id/{typeId}/products-groups-variant-2/{vehicleId}/lang-id/{langId} Category tree — nested JSON API-GCA-002
Recommended for building hierarchical tree UIs. Returns a nested children-based structure.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
vehicleId | int | Required | 19942 |
langId | int | Required | 4 |
GET /api/category/type-id/{typeId}/products-groups-variant-3/{vehicleId}/lang-id/{langId} Category tree — path-based API-GCA-003
Builds the tree from full ancestor paths — useful for breadcrumb-style navigation.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
vehicleId | int | Required | 19942 |
langId | int | Required | 4 |
GET /api/category/type-id/{typeId}/products-groups-variant-4/{vehicleId}/lang-id/{langId} Deepest category IDs only API-GCA-004
Returns only the leaf-level (deepest) categoryId values — exactly what you need for the articles endpoint. Fastest way to go from vehicle → part categories.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
vehicleId | int | Required | 19942 |
langId | int | Required | 4 |
GET /api/category/type-id/{typeId}/list-category-tree-structure/lang-id/{langId} Full category tree — all vehicles API-GCA-005
Returns the complete nested product-group tree for the given vehicle type, independent of any specific vehicle. Use to build a universal parts-catalog browser.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
langId | int | Required | 4 |
GET /api/category/list-products-names/lang-id/{langId} Flat list of all product group names API-GCA-006
| Parameter | Type | Required | Example |
|---|---|---|---|
langId | int | Required | 4 |
GET /api/category/search-for-the-commodity-group-tree-by-description/type-id/{typeId}/lang-id/{langId}/search-text/{searchText} Search categories by text API-GCA-007
Full-text search over product group descriptions. Returns a nested tree of matching groups. Useful for autocomplete category search.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Required | 1 |
langId | int | Required | 4 |
searchText | string | Required | VALVE |
Articles GET
Article GET endpoints 16 endpoints
GET/api/articles/list/type-id/{typeId}/vehicle-id/{vehicleId}/category-id/{categoryId}/lang-id/{langId}Articles by vehicle + categoryAPI-GAR-001
Primary endpoint for parts lookup. Returns all articles matching the vehicle and product group, including part numbers, supplier info, and image URLs.
| Parameter | Type | Required | Example |
|---|---|---|---|
typeId | int | Optional | 1 |
vehicleId | int | Optional | 19942 |
categoryId | int | Optional | 100260 |
langId | int | Optional | 4 |
GET/api/articles/details/article-id/{articleId}/lang-id/{langId}Full article details by article IDAPI-GAR-002
| Parameter | Type | Required | Example |
|---|---|---|---|
articleId | int | Required | |
langId | int | Required | 4 |
GET/api/articles/search-by-article-noSearch articles by part number (query string)API-GAR-003
Pass parameters as query-string values. Accepts any article number type — article number, EAN, OEM, or trade number.
| Parameter | Type | Location | Required |
|---|---|---|---|
articleNo | string | query | Required |
langId | int | query | Optional |
GET/api/articles/search-by-articles-no-supplier-idSearch by article number + supplierAPI-GAR-004
| Parameter | Type | Location | Required |
|---|---|---|---|
articleNo | string | query | Required |
supplierId | int | query | Required |
langId | int | query | Optional |
GET/api/articles/article-number-details/type-id/{typeId}Complete details by article numberAPI-GAR-005
| Parameter | Type | Location | Required |
|---|---|---|---|
typeId | int | path | Required |
articleNo | string | query | Required |
supplierId | int | query | Optional |
langId | int | query | Optional |
GET/api/articles/article-complete-details/type-id/{typeId}Complete details by article IDAPI-GAR-006
| Parameter | Type | Location | Required |
|---|---|---|---|
typeId | int | path | Required |
articleId | int | query | Required |
langId | int | query | Optional |
GET/api/articles/article-all-media-infoAll media for an articleAPI-GAR-007
Returns all associated media (images, PDFs, diagrams) with CDN URLs. See also Media endpoint for direct file access.
| Parameter | Type | Location | Required |
|---|---|---|---|
articleId | int | query | Required |
langId | int | query | Optional |
GET/api/articles/get-compatible-cars-by-article-number/type-id/{typeId}Compatible vehicles by article numberAPI-GAR-008
| Parameter | Type | Location | Required |
|---|---|---|---|
typeId | int | path | Required |
articleNo | string | query | Required |
supplierId | int | query | Optional |
langId | int | query | Optional |
countryFilterId | int | query | Optional |
GET/api/articles/get-compatible-cars-by-article-number/type-id/{typeId}Compatible vehicles by article number + supplierAPI-GAR-009
Variant that requires both article number and supplier ID for a precise lookup.
| Parameter | Type | Location | Required |
|---|---|---|---|
typeId | int | path | Required |
articleNo | string | query | Required |
supplierId | int | query | Required |
langId | int | query | Optional |
countryFilterId | int | query | Optional |
GET/api/articles/list-of-parts-for-article/article-id/{articleId}/lang-id/{langId}/country-filter-id/{countryFilterId}Sub-parts / components for an articleAPI-GAR-0010
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
langId | int | Required |
countryFilterId | int | Required |
GET/api/articles/selecting-list-of-accessories-list-for-the-article/article-id/{articleId}/lang-id/{langId}/country-filter-id/{countryFilterId}Accessories for an articleAPI-GAR-0011
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
langId | int | Required |
countryFilterId | int | Required |
GET/api/articles/selection-of-the-criteria-for-articles-and-vehicle/type-id/{typeId}/product-id/{productId}/vehicle-id/{vehicleId}/supplier-id/{supplierId}/lang-id/{langId}/country-filter-id/{countryFilterId}Fitment criteria for article + vehicleAPI-GAR-0012
| Parameter | Type | Required |
|---|---|---|
typeId | int | Required |
productId | int | Required |
vehicleId | int | Required |
supplierId | int | Required |
langId | int | Required |
countryFilterId | int | Required |
GET/api/articles/selection-of-all-specifications-criterias-for-the-article/article-id/{articleId}/lang-id/{langId}/country-filter-id/{countryFilterId}All specification criteria for an articleAPI-GAR-0013
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
langId | int | Required |
countryFilterId | int | Required |
GET/api/articles/selecting-item-coordinators-on-the-parts-diagram-image-for-the-parts-list/article-id/{articleId}Diagram item coordinatesAPI-GAR-0014
Returns X/Y coordinates for article positions on parts-diagram images. Use in conjunction with the media endpoint to overlay hotspots.
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
GET/api/articles/get-article-categories/article-id/{articleId}/lang-id/{langId}All categories an article belongs toAPI-GAR-0015
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
langId | int | Required |
GET/api/articles/get-article-category/article-id/{articleId}/lang-id/{langId}Primary category of an articleAPI-GAR-0016
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
langId | int | Required |
Articles POST
Content-Type: application/json), making them easier to call from environments that can't pass long path parameters.Article POST endpoints 7 endpoints
POST/api/articles/list-articlesArticles by vehicle + categoryAPI-PAR-001
JSON body: typeId, vehicleId, categoryId, langId.
POST/api/articles/detailsFull article detailsAPI-PAR-002
JSON body: articleId, langId.
POST/api/articles/quick-article-searchQuick search by numberAPI-PAR-003
JSON body: articleNo, langId.
POST/api/articles/article-number-detailsComplete details by article numberAPI-PAR-004
JSON body: typeId, articleNo, supplierId, langId.
POST/api/articles/article-id-complete-detailsComplete details by article IDAPI-PAR-005
JSON body: typeId, articleId, langId.
POST/api/articles/article-all-media-infoAll media for an articleAPI-PAR-006
JSON body: articleId, langId.
POST/api/articles/get-compatible-cars-by-article-numberCompatible vehicles by article numberAPI-PAR-007
JSON body: typeId, articleNo, supplierId, langId, countryFilterId.
OEM Numbers
OEM number endpoints 4 endpoints
GET/api/articles-oem/search-by-article-oem-noSearch aftermarket parts by OEM numberAPI-GARO-001
Pass articleOemNo and langId as query-string parameters. Returns all aftermarket articles matching the OEM reference, with images.
| Parameter | Type | Location | Required | Example |
|---|---|---|---|---|
langId | int | query | Required | 4 |
articleOemNo | string | query | Optional | 8F0513035N |
GET/api/articles-oem/search-all-equal-oem-no/lang-id/{langId}/article-oem-no/{articleOemNo}All equal OEM numbersAPI-GARO-002
| Parameter | Type | Required | Example |
|---|---|---|---|
langId | int | Required | 4 |
articleOemNo | string | Required | 8F0513035N |
GET/api/articles-oem/selecting-a-list-of-cars-for-oem-part-number/type-id/{typeId}/lang-id/{langId}/country-filter-id/{countryFilterId}/manufacturer-id/{manufacturerId}/article-oem-no/{articleOemNo}Vehicles compatible with an OEM partAPI-GARO-003
| Parameter | Type | Required |
|---|---|---|
typeId | int | Required |
langId | int | Required |
countryFilterId | int | Required |
manufacturerId | int | Required |
articleOemNo | string | Required |
GET/api/articles-oem/selecting-oem-parts-vehicle-modification-description-product-group/type-id/{typeId}/vehicle-id/{vehicleId}/lang-id/{langId}/search-param/{searchParam}OEM parts for vehicle by search termAPI-GARO-004
| Parameter | Type | Required |
|---|---|---|
typeId | int | Required |
vehicleId | int | Required |
langId | int | Required |
searchParam | string | Required |
Cross-References
Look up equivalent parts across suppliers. All cross-reference endpoints are under /api/artlookup/.
Cross-reference endpoints 9 endpoints
GET/api/artlookup/select-article-cross-references/article-id/{articleId}/lang-id/{langId}All cross-references for an articleAPI-GARL-001
| Parameter | Type | Required |
|---|---|---|
articleId | int | Required |
langId | int | Required |
GET/api/artlookup/search-for-cross-references-through-oem-numbers/article-no/{articleNo}/supplierId/{supplierId}OEM cross-refs for aftermarket partAPI-GARL-002
| Parameter | Type | Required |
|---|---|---|
articleNo | string | Required |
supplierId | int | Required |
GET/api/artlookup/search-for-the-oem-cross-references-through-aftermarket-parts-references/article-oem-no/{articleOemNo}Aftermarket parts from OEM numberAPI-GARL-003
| Parameter | Type | Required |
|---|---|---|
articleOemNo | string | Required |
GET/api/artlookup/search-for-analogue-of-spare-parts-by-oem-number/article-oem-no/{articleOemNo}Analogues by OEM numberAPI-GARL-004
| Parameter | Type | Required |
|---|---|---|
articleOemNo | string | Required |
GET/api/artlookup/search-for-analog-spare-parts-by-the-articles-numbers/lang-id/{langId}/articleNo/{articleNo}Analogues by article numberAPI-GARL-005
| Parameter | Type | Required |
|---|---|---|
langId | int | Required |
articleNo | string | Required |
GET/api/artlookup/search-for-cross-numbers/lang-id/{langId}/article-type/{articleType}/article-no/{articleNo}Cross numbers by article number + typeAPI-GARL-006
See Article Number Types for valid articleType values (ArticleNumber, OENumber, etc.).
| Parameter | Type | Required |
|---|---|---|
langId | int | Required |
articleType | string | Required |
articleNo | string | Required |
GET/api/artlookup/search-articles-by-article-noArticle lookup by number (query string)API-GARL-007
| Parameter | Type | Location | Required |
|---|---|---|---|
articleNo | string | query | Required |
langId | int | query | Optional |
GET/api/artlookup/search-for-cross-references-through-oem-numbers-by-article-idOEM cross-refs by article ID (query string)API-GARL-008
| Parameter | Type | Location | Required |
|---|---|---|---|
articleId | int | query | Required |
langId | int | query | Optional |
GET/api/artlookup/select-article-cross-references-partial-matchCross-references with partial number matchAPI-GARL-009
| Parameter | Type | Location | Required |
|---|---|---|---|
articleNo | string | query | Required |
langId | int | query | Optional |
Engines
Engine endpoints 1 endpoint
GET/api/engines/engine-details/engine-id/{engId}/lang-id/{langId}Full engine specificationAPI-GEN-001
Returns detailed technical information about an engine: displacement, power, torque, valves, fuel type, manufacturer, and fitment vehicle list. Obtain engId from vehicle detail responses.
| Parameter | Type | Required | Example |
|---|---|---|---|
engId | int | Optional | 19228 |
langId | int | Required | 4 |
Suppliers & Media
Supplier & media endpoints 2 endpoints
GET/api/suppliers/listAll part suppliersAPI-GSPL-001
Returns every aftermarket supplier in the dataset with their TecDoc supplierId, name, and brand details. No parameters required. Cache this list — it rarely changes.
GET/api/media/supplier-id/{supplierId}/media-type/{mediatype}/type/{type}/article-file-name/{articleFileName}Raw media asset by filenameAPI-GMD-001
Streams or redirects to a specific media asset (image, PDF, diagram) from the CDN. The articleFileName comes from article detail responses. mediatype examples: IMAGE, PDF, OTHERS.
| Parameter | Type | Required |
|---|---|---|
supplierId | int | Required |
mediatype | string | Required |
type | string | Required |
articleFileName | string | Required |
VIN Decoding
VIN endpoints 5 endpoints
GET/api/vin/tecdoc-vin-check/{vinNo}TecDoc-native VIN decodeAPI-GVIN-001
Uses the TecDoc VIN REST API (requires a valid VIN_API_KEY configured on the server). Returns the matched TecDoc vehicle record including typeId, make, model, and engine specs.
| Parameter | Type | Required | Example |
|---|---|---|---|
vinNo | string | Required | WDBFA68F42F202731 |
GET/api/vin/decoder-v1/{vinNo}VIN decode — structural parser (v1)API-GVIN-002
Decodes the VIN structure locally using standard WMI/VDS/VIS rules — no external API call. Returns manufacturer, country, year, plant, and sequence number from the VIN itself.
| Parameter | Type | Required |
|---|---|---|
vinNo | string | Required |
GET/api/vin/decoder-v2/{vinNo}VIN decode — database lookup (v2)API-GVIN-003
Searches a curated VIN database for a richer set of decoded attributes including engine, trim level, and country of manufacture.
| Parameter | Type | Required |
|---|---|---|
vinNo | string | Required |
GET/api/vin/decoder-v3/{vinNo}VIN decode — scraped external source (v3)API-GVIN-004
Fetches and parses vehicle information from an external public VIN registry. Slower than v1/v2 due to the outbound HTTP call.
| Parameter | Type | Required |
|---|---|---|
vinNo | string | Required |
GET/api/vin/decoder-v5/{vinNo}VIN decode — aggregated (v5, recommended)API-GVIN-006
Combines results from v1, v2, and v3 into a single response keyed as vin-data-1, vin-data-2, vin-data-3. Recommended when you need the most complete picture.
| Parameter | Type | Required |
|---|---|---|
vinNo | string | Required |
Start building today
Create a free trial account — no credit card required. All endpoints available immediately.