Get List of Repairs by Vehicle

CarMD API works on all vehicles sold in the US since 1996.

This API provides a list of maintenance and check engine light repairs by specific vehicle (VIN) or by year make model and engine.

The intended purpose of this API is allowing a user to input their vehicle information and retrieve a list of repairs for their vehicle. And if further information is needed the user is able to use another API to pull specific information on that repair such as labor hours and parts needed for that repair.

For specific details, please see our API Documentation.

Testing the API

This document will guide a user to testing the endpoint without having to touch any code other than the endpoint data.

1 – Register an account for free or login to grab your API keys.

  • Registration is easy with just an email and password and then you’re ready to start using the APIs.
  • We do not ask for credit card information on registration.
  • Using the APIs is FREE to a limit.
  • Register to get access

Once you reach your dashboard, click Next as shown below to view your keys.

CarMD API member page

2 – Download and open your RESTful client

Install Advanced REST client for Google Chrome.

Open the client by going to the app. Then click Launch app.

Open your RESTful client

3 – Add Repair API endpoint and data

Once you’re at the main screen of the client insert the endpoint and parameter data into the Request URL field at the top.

Example endpoint and parameter data 1 (copy and paste the line below into the client):

http://dev2-api.carmd.com/v3.0/repairlist?vin=1J4FA59S5YP721551

4 – Adding your header

At this point we’re prepping to add your authorization and partner keys to the header, first lets setup the header.

Under Parameters, click Insert headers set.

The default header will display, then click USE THIS SET

The result should look like below:

5 – Adding your keys to the header

Here we’re going to add your keys to the header. First lets open up some fields in your header by clicking ADD HEADER twice.

It should look like this.

Now add your keys to the empty header fields.

6 – Sending your request

Submit your request by clicking SEND. The response may take a few seconds.

Your response should look like the below.
This is a list of all the maintenance repairs and check engine light repairs on this vehicle.

To get specific information on a repair such as parts needed for repair and labor hours involved, continue to Step 7.

7 – Get specific information on a repair
To get further detailed information on each repair item, you will need use a different API called Get Repair Info.

In the Request URL field of your Advanced REST Client replace the current API endpoint with this one

http://dev2-api.carmd.com/v3.0/repairinfo?repair_code=2bff9132c36f-10200010Y

Where the field repair_code is the code of the repair in the response of Get Repair List.

Response

Each response is broken down into two portions, one is the message which contains basic diagnostic results of the request and the other is the data.

Your fix information will be contained in the ‘data’ field.

CarMD API works on all vehicles sold in the US since 1996.

This API provides a list of maintenance and check engine light repairs by specific vehicle (VIN) or by year make model and engine.

The intended purpose of this API is allowing a user to input their vehicle information and retrieve a list of repairs for their vehicle. And if further information is needed the user is able to use another API to pull specific information on that repair such as labor hours and parts needed for that repair.

For specific details, please see our API Documentation.

Testing the API

This document will guide a user to testing the endpoint without having to touch any code other than the endpoint data.

1 – Register an account for free or login to grab your API keys.

  • Registration is easy with just an email and password and then you’re ready to start using the APIs.
  • We do not ask for credit card information on registration.
  • Using the APIs is FREE to a limit.
  • Register to get access

Once you reach your dashboard, click Next as shown below to view your keys.

CarMD API member page

2 – Download and open your RESTful client

Install Advanced REST client for Google Chrome.

Open the client by going to the app. Then click Launch app.

Open your RESTful client

3 – Add Repair API endpoint and data

Once you’re at the main screen of the client insert the endpoint and parameter data into the Request URL field at the top.

Example endpoint and parameter data 1 (copy and paste the line below into the client):

http://dev2-api.carmd.com/v3.0/repairlist?vin=1J4FA59S5YP721551

4 – Adding your header

At this point we’re prepping to add your authorization and partner keys to the header, first lets setup the header.

Under Parameters, click Insert headers set.

The default header will display, then click USE THIS SET

The result should look like below:

5 – Adding your keys to the header

Here we’re going to add your keys to the header. First lets open up some fields in your header by clicking ADD HEADER twice.

It should look like this.

Now add your keys to the empty header fields.

6 – Sending your request

Submit your request by clicking SEND. The response may take a few seconds.

Your response should look like the below.
This is a list of all the maintenance repairs and check engine light repairs on this vehicle.

To get specific information on a repair such as parts needed for repair and labor hours involved, continue to Step 7.

7 – Get specific information on a repair
To get further detailed information on each repair item, you will need use a different API called Get Repair Info.

In the Request URL field of your Advanced REST Client replace the current API endpoint with this one

http://dev2-api.carmd.com/v3.0/repairinfo?repair_code=2bff9132c36f-10200010Y

Where the field repair_code is the code of the repair in the response of Get Repair List.

Response

Each response is broken down into two portions, one is the message which contains basic diagnostic results of the request and the other is the data.

Your fix information will be contained in the ‘data’ field.