CarMD API
api.carmd.com · Company
Vehicle diagnostics API — decode OBD-II codes, get repair costs, recall data, maintenance schedules, and parts needed by VIN. 17,000+ professionally maintained error codes.
Authentication
API Key authentication
Requires Authorization and partner-token headers. Free and paid plans available at carmd.com.
Sample Requests
GET
Decode OBD code for vehicle
Get repair info for a specific OBD-II code on a vehicle identified by VIN.
https://api.carmd.com/v3.0/code?dtc=p0420&vin=1G1ZT53806F109149
Hover any highlighted part to learn what it does
Headers — extra info sent with the request
| Authorization | Bearer YOUR_AUTH_TOKEN |
| partner-token | YOUR_PARTNER_TOKEN |
curl -X GET "https://api.carmd.com/v3.0/code?dtc=p0420&vin=1G1ZT53806F109149" \ -H "Authorization: Bearer YOUR_AUTH_TOKEN" \ -H "partner-token: YOUR_PARTNER_TOKEN"
import requests
params = {
"dtc": "p0420",
"vin": "1G1ZT53806F109149"
}
headers = {
"Authorization": "Bearer YOUR_AUTH_TOKEN",
"partner-token": "YOUR_PARTNER_TOKEN"
}
response = requests.get(
"https://api.carmd.com/v3.0/code",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.carmd.com/v3.0/code');
url.searchParams.set('dtc', 'p0420');
url.searchParams.set('vin', '1G1ZT53806F109149');
const response = await fetch(url, {
headers: {
'Authorization': 'Bearer YOUR_AUTH_TOKEN',
'partner-token': 'YOUR_PARTNER_TOKEN'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.carmd.com/v3.0/code")
q := baseURL.Query()
q.Set("dtc", "p0420")
q.Set("vin", "1G1ZT53806F109149")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("Authorization", "Bearer YOUR_AUTH_TOKEN")
req.Header.Set("partner-token", "YOUR_PARTNER_TOKEN")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.carmd.com/v3.0/code")
uri.query = URI.encode_www_form({
"dtc" => "p0420",
"vin" => "1G1ZT53806F109149"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer YOUR_AUTH_TOKEN"
req["partner-token"] = "YOUR_PARTNER_TOKEN"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.carmd.com/v3.0/code?" . http_build_query([
"dtc" => "p0420",
"vin" => "1G1ZT53806F109149"
]);
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"Authorization: Bearer YOUR_AUTH_TOKEN",
"partner-token: YOUR_PARTNER_TOKEN"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
Get maintenance schedule
Get upcoming maintenance items for a vehicle at a given mileage.
https://api.carmd.com/v3.0/maint?vin=1G1ZT53806F109149&mileage=75000
Hover any highlighted part to learn what it does
Headers — extra info sent with the request
| Authorization | Bearer YOUR_AUTH_TOKEN |
| partner-token | YOUR_PARTNER_TOKEN |
curl -X GET "https://api.carmd.com/v3.0/maint?vin=1G1ZT53806F109149&mileage=75000" \ -H "Authorization: Bearer YOUR_AUTH_TOKEN" \ -H "partner-token: YOUR_PARTNER_TOKEN"
import requests
params = {
"vin": "1G1ZT53806F109149",
"mileage": "75000"
}
headers = {
"Authorization": "Bearer YOUR_AUTH_TOKEN",
"partner-token": "YOUR_PARTNER_TOKEN"
}
response = requests.get(
"https://api.carmd.com/v3.0/maint",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.carmd.com/v3.0/maint');
url.searchParams.set('vin', '1G1ZT53806F109149');
url.searchParams.set('mileage', '75000');
const response = await fetch(url, {
headers: {
'Authorization': 'Bearer YOUR_AUTH_TOKEN',
'partner-token': 'YOUR_PARTNER_TOKEN'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.carmd.com/v3.0/maint")
q := baseURL.Query()
q.Set("vin", "1G1ZT53806F109149")
q.Set("mileage", "75000")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("Authorization", "Bearer YOUR_AUTH_TOKEN")
req.Header.Set("partner-token", "YOUR_PARTNER_TOKEN")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.carmd.com/v3.0/maint")
uri.query = URI.encode_www_form({
"vin" => "1G1ZT53806F109149",
"mileage" => "75000"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer YOUR_AUTH_TOKEN"
req["partner-token"] = "YOUR_PARTNER_TOKEN"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.carmd.com/v3.0/maint?" . http_build_query([
"vin" => "1G1ZT53806F109149",
"mileage" => "75000"
]);
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"Authorization: Bearer YOUR_AUTH_TOKEN",
"partner-token: YOUR_PARTNER_TOKEN"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- Register at carmd.com for API credentials
- You need both an Authorization Bearer token and a partner-token
- Set both as headers on every request
- Try GET /code?vin=YOUR_VIN&dtc=p0420 for OBD code lookup
- Try GET /maint?vin=YOUR_VIN&mileage=50000 for maintenance schedule
What can you build with CarMD API?
CarMD API is a Company API. Developers commonly use company APIs for:
- enriching CRM records with company firmographics
- building lead-generation and prospecting tools
- verifying business identity and registration details
- monitoring competitors and market intelligence
- powering B2B data enrichment pipelines
API Key authentication. You'll receive a key after signing up. Send it with every request — in a header or query parameter. Keep it out of client-side code and never commit it to version control. CarMD API is free to use up to a usage limit, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide