ReportCar Docs

Vehicle Lookup

Retrieve comprehensive safety data for a specific vehicle

GET/api/b2b/vehicle/:plate

Retrieve real-time safety information for a specific license plate including risk score, star rating, behavior breakdown, and recent reports.

Try It Out

Interactive API Tester

License plate number

Include report locations

Request

Path Parameters

platerequiredstring

License plate number to lookup

Query Parameters

include_locationsoptionalboolean

Include geographic coordinates for recent reports. Default: false

Example Request

curl https://reportcar.com/api/b2b/vehicle/ABC123?include_locations=true \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Returns a vehicle object with comprehensive safety data:

{
  "license_plate": "ABC123",
  "risk_score": 89,
  "star_rating": 4,
  "total_reports": 12,
  "recent_reports": {
    "last_7_days": 2,
    "last_30_days": 5,
    "last_90_days": 8
  },
  "behavior_breakdown": {
    "distracted_driving": 5,
    "aggressive_driving": 4,
    "reckless_driving": 2,
    "parking_violation": 1
  },
  "confidence_score": 0.83,
  "flagged_for_review": false,
  "metadata": {
    "first_report_date": "2024-01-15T08:30:00Z",
    "last_report_date": "2025-11-28T14:22:00Z",
    "unique_reporters": 10
  }
}

Response Fields

license_platestring

License plate number

risk_scoreinteger

Overall risk score (0-1000). Higher = more dangerous

star_ratinginteger

Star rating (1-5 stars). 5 = safest

total_reportsinteger

Total number of reports for this vehicle

recent_reportsobject

Breakdown of reports by recency

behavior_breakdownobject

Count of each behavior type

confidence_scorefloat

Data confidence (0.0-1.0) based on unique reporters

flagged_for_reviewboolean

Whether the vehicle is flagged for manual review

metadataobject

Additional metadata about the vehicle history

Error Responses

404 - Vehicle Not Found

{
  "error": "Vehicle not found",
  "message": "No reports found for license plate: XYZ999"
}

401 - Unauthorized

{
  "error": "Invalid API key",
  "message": "The provided API key is invalid or has been revoked"
}

Use Case Example

Rideshare Driver Screening

Screen potential drivers during the application process:

async function screenDriver(licensePlate) {
  const response = await fetch(
    `https://reportcar.com/api/b2b/vehicle/${licensePlate}`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  const vehicle = await response.json();

  // Reject if risk score too high
  if (vehicle.risk_score > 150) {
    return {
      approved: false,
      reason: 'High risk score'
    };
  }

  // Reject if flagged for review
  if (vehicle.flagged_for_review) {
    return {
      approved: false,
      reason: 'Flagged for manual review'
    };
  }

  // Approve if low risk
  return {
    approved: true,
    risk_level: vehicle.star_rating >= 4 ? 'low' : 'medium'
  };
}