Getting Started

Introduction

Welcome to the MarketVerify API documentation. MarketVerify provides personal injury law firms and legal technology integrators with a powerful REST API to generate defensible diminished value reports from intake, backed by real-time market data.

This documentation covers all available endpoints, authentication, request/response schemas, and code examples in multiple languages.

Base URL

https://api.marketverify.io

Authenticating Requests

The MarketVerify API uses API key authentication. Authenticate by sending an Authorization header with the value of your API key on every request.

All authenticated endpoints are marked with a requires authentication badge. Never expose your API key in client-side code.

You can retrieve your API key by visiting your dashboard and navigating to Settings. You may also regenerate your key from there at any time.

Example Header

Authorization: YOUR_API_KEY

Endpoints

Diminished Value Report

requires authentication

Generate a full diminished value report for a vehicle. Identify the vehicle using either a license plate OR year/make/model. Returns a complete DV analysis package including market comparables and a PDF report ready for demand packages.

POST/api/dv/report

Example request:

curl

curl --request POST \
    "https://api.marketverify.io/api/dv/report" \
    --header "Authorization: YOUR_API_KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data '{"client_info":{"name":"John Smith","phone":"555-123-4567","email":"john.smith@email.com"},"license_plate":"ABC1234","plate":"GA","zip":"30301","state":"GA","accidentDate":"2024-03-15","mileage":42000}'

Example response (200, Successful):

json

{
  "success": true,
  "report": {
    "pre_accident_value": 28500,
    "post_accident_value": 24225,
    "diminished_value": 4275,
    "client": {
      "first_name": "John",
      "last_name": "Smith"
    },
    "vehicle": {
      "year": "2020",
      "make": "Honda",
      "model": "Accord",
      "trim": "EX-L 4dr Sedan",
      "license_plate": "ABC1234"
    },
    "pre_accident_comparables": [
      {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "price": 28200,
        "mileage": 42000,
        "source": "AutoTrader"
      },
      {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "price": 28800,
        "mileage": 38500,
        "source": "Cars.com"
      }
    ],
    "post_accident_comparables": [
      {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "price": 24000,
        "mileage": 41000,
        "damage_history": true,
        "source": "AutoTrader"
      },
      {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "price": 24450,
        "mileage": 43000,
        "damage_history": true,
        "source": "Cars.com"
      }
    ],
    "pdf_url": "https://api.marketverify.io/reports/dv-1hgcm82633a123456-20240315.pdf",
    "generated_at": "2024-03-20T14:32:00Z"
  }
}

RequestBody Parameters

client_info.namestring

Full client name of vehicle owner.

client_info.phonestring

Client phone number.

client_info.emailstring

Client email address.

license_platestring

Vehicle license plate number. Use this OR year/make/model to identify the vehicle.

platestring

Must be at least 2 characters. Must not be greater than 2 characters.

yearnumber

Vehicle model year (e.g., 2020). Use with make/model instead of license_plate.

makestring

Vehicle manufacturer (e.g., Honda). Use with year/model instead of license_plate.

modelstring

Vehicle model name (e.g., Accord). Use with year/make instead of license_plate.

trim (optional)string

Vehicle trim level (e.g., EX-L). Improves accuracy when using year/make/model.

zipstring

Client ZIP code for regional market data.

statestring

Two-letter US state code where the loss occurred.

accidentDatestring

Date of loss in YYYY-MM-DD format.

mileagenumber

Current vehicle mileage at time of loss.

ResponseResponse Fields

successboolean

Whether the API call was successful.

reportobject

The full diminished value report PDF object.

pre_accident_valuenumber

Fair market value of the vehicle before the accident in USD.

post_accident_valuenumber

Fair market value of the vehicle after repairs in USD.

diminished_valuenumber

Calculated diminished value amount in USD.

pre_accident_comparablesarray

Array of market comparable vehicles used to determine pre-accident value.

post_accident_comparablesarray

Array of market comparable vehicles (with similar damage history) used to determine post-accident value.

pdf_urlstring

URL to download the generated PDF diminished value report.

Demand Cover Letter + Diminished Value Report

requires authentication

Generate a complete demand package including a professionally formatted cover letter addressed to the insurance carrier along with the full diminished value report. Identify the vehicle using either a license plate OR year/make/model. Ready for immediate submission to adjusters.

POST/api/dv/demand-package

Example request:

curl

curl --request POST \
    "https://api.marketverify.io/api/dv/demand-package" \
    --header "Authorization: YOUR_API_KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data '{"client_info":{"name":"John Smith","phone":"555-123-4567","email":"john.smith@email.com","claimNumber":"CLM-2024-78392","policyNumber":"POL-9876543","insuranceCompanyName":"State Farm Insurance"},"year":2020,"make":"Honda","model":"Accord","trim":"EX-L","zip":"30301","state":"GA","accidentDate":"2024-03-15","mileage":42000,"adjuster_first_name":"Jane","adjuster_last_name":"Doe","firm_name":"Smith & Associates Law Firm","attorney_name":"Michael Smith, Esq."}'

Example response (200, Successful):

json

{
  "success": true,
  "package": {
    "pre_accident_value": 28500,
    "post_accident_value": 24225,
    "diminished_value": 4275,
    "client": {
      "first_name": "John",
      "last_name": "Smith"
    },
    "vehicle": {
      "year": "2020",
      "make": "Honda",
      "model": "Accord",
      "trim": "EX-L 4dr Sedan"
    },
    "client_info": {
      "name": "John Smith",
      "phone": "555-123-4567",
      "email": "john.smith@email.com",
      "claimNumber": "CLM-2024-78392",
      "insuranceCompanyName": "State Farm Insurance"
    },
    "cover_letter_pdf": "https://api.marketverify.io/reports/demand-letter-clm-2024-78392.pdf",
    "dv_report_pdf": "https://api.marketverify.io/reports/dv-1hgcm82633a123456-20240315.pdf",
    "combined_pdf": "https://api.marketverify.io/reports/demand-package-clm-2024-78392.pdf",
    "generated_at": "2024-03-20T14:32:00Z"
  }
}

RequestBody Parameters

client_info.namestring

Full client name of vehicle owner.

client_info.phonestring

Client phone number.

client_info.emailstring

Client email address.

license_platestring

Vehicle license plate number. Use this OR year/make/model to identify the vehicle.

platestring

Must be at least 2 characters. Must not be greater than 2 characters.

yearnumber

Vehicle model year (e.g., 2020). Use with make/model instead of license_plate.

makestring

Vehicle manufacturer (e.g., Honda). Use with year/make instead of license_plate.

modelstring

Vehicle model name (e.g., Accord). Use with year/make instead of license_plate.

trim (optional)string

Vehicle trim level (e.g., EX-L). Improves accuracy when using year/make/model.

zipstring

Client ZIP code for regional market data.

statestring

Two-letter US state code where the loss occurred.

accidentDatestring

Date of loss in YYYY-MM-DD format.

mileagenumber

Current vehicle mileage at time of loss.

client_info.claimNumber (optional)string

Insurance claim number for reference.

client_info.policyNumberstring

Insurance policy number of the at-fault party.

client_info.insuranceCompanyNamestring

Name of the at-fault insurance carrier.

adjuster_first_namestring

First name of the insurance adjuster.

adjuster_last_namestring

Last name of the insurance adjuster.

firm_namestring

Name of the law firm submitting the demand.

attorney_namestring

Name of the attorney handling the case.

ResponseResponse Fields

successboolean

Whether the API call was successful.

packageobject

The full demand package PDF object (cover letter + DV report).

pre_accident_valuenumber

Fair market value of the vehicle before the accident in USD.

post_accident_valuenumber

Fair market value of the vehicle after repairs in USD.

diminished_valuenumber

Calculated diminished value amount in USD.

cover_letter_pdfstring

URL to download the demand cover letter PDF.

dv_report_pdfstring

URL to download the diminished value report PDF.

combined_pdfstring

URL to download the combined demand package PDF (cover letter + DV report).