Auto parts catalog API for your project
Resolve VIN/frame identifiers and retrieve an OEM catalog tree, diagrams and part numbers through a server REST API. Build the lookup journey into your own store or portal interface.
What the API provides
1. Identify the vehicle
Use a VIN, frame or chassis number, depending on the catalog. Supported brands also offer selection by vehicle parameters.
2. Open a diagram
Navigate catalog groups to the relevant assembly. The diagram and parts list connect the illustration to a catalog part number.
3. Continue to purchasing
Use the OEM part number in your store. Prices, stock and orders remain in your system; the widget can link to your price search or request workflow.
Before paying, test the brands, models and years you need using your own examples. VIN/frame coverage, diagrams and part data depend on the catalog.
How server integration works
- Activate Trial for your project and issue a server Bearer token in your account. Keep it on your backend.
- Resolve a vehicle through /vehicles/resolve and retain the returned vehicle_hash.
- Retrieve catalog groups, select a diagram and request its parts. Use the same vehicle_hash throughout the flow.
curl -X POST 'https://api.vinalfa.com/oem/v2/vehicles/resolve' \
-H 'Authorization: Bearer YOUR_SERVER_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"identifier":"YOUR_VIN_OR_FRAME"}'Read the API methods, limits and response documentation →
If you need a ready-made catalog interface instead of custom development, start with the embeddable widget. Website widget →
Connection cost and Trial evaluation
Trial provides 5 days and 10 VIN lookups to test integration. After testing, choose a plan based on actual usage. Subscription access and website development are separate costs.
A subscription provides catalog access and the features of the chosen plan. Installation follows the self-service guide; personal integration and store development are agreed separately.
Questions before connecting
Can I connect a catalog for free?
The initial Trial provides 5 days and 10 VIN lookups. This is temporary test access. Continued use requires an active paid subscription.
Are supplier prices and stock included?
Vinalfa helps identify OEM part numbers and diagrams. Price sources, stock, the cart and order processing remain on your store’s side.
Is every VIN supported?
Coverage depends on brand, model, year and available catalog data. Test relevant examples in the demo and Trial before choosing a paid plan.
Can I expose the server token in the browser?
No. The API Bearer token stays on your server. The ready-made browser widget uses a separate public widget token configured for the project.