GET Session Results

Retrieve the completed vehicle details, inspection and photo results belonging to the API-Key by referencing the session_key.

https://openapi.paveapi.com/v1/sessions/:session_key/results

Replace :session_key with the unique session_key returned from your previous request, and PAVE will return the corresponding session results.

Path Parameters	Type	Description
session_key	string	Unique session_key generated when the new session was created

Headers	Type	Description
API-Key	string	The API-Key that was provided for your account
API-Token	string	The API-Token used when the session was created
API-Timestamp	string	UTC Datetime string, example: 2021-05-30T12:49:19Z

Sample Request

curl --location --request GET 'https://openapi.paveapi.com/v1/sessions/UNG-5IXXXXXXXX/results' \

PAVE Inspection Results Data

This link below provides a PDF document that includes a detailed description of the various objects used in an inspection session JSON that is SESSION:COMPLETE.

158KB

PAVE Inspection Results Data.pdf

pdf

Click to open PDF

These objects include the Session Object, which contains information about the inspection session, such as the session key, theme, status, and contact details. The Vehicle Object has information on the inspected vehicle, including the VIN, make, model, and odometer reading. The Photos Object contains information about the photos taken during the inspection, including the URL where they are stored and whether they were approved in the photo QA process. The Location Object provides details about the location of the inspection. Lastly, the Inspection Object contains information about the damages detected during the inspection, including the total number of damages and their maximum grade per item.

Sample Response (200: Ok)

The session is COMPLETE and the final results are available.

{
    "event": "SESSION:COMPLETE",
    "session": {
        "session_key": "SMG-JLI***KEVE",
        "theme": "LITE",
        "active": true,
        "status": "COMPLETE",
        "redirect_url": "https:\/\/www.autotur***.com\/sell\/thank-you\/5FNRL6**LB051014?dealer=1010",
        "inspect_started_at": "2023-12-07T17:33:36+00:00",
        "inspect_ended_at": "2023-12-07T17:43:05+00:00",
        "capture_duration": 230,
        "inspect_duration": 569,
        "created_at": "2023-12-07T17:33:23+00:00",
        "updated_at": "2023-12-07T17:44:07+00:00",
        "language": "en",
        "options": {
            "client_id": "1**-2**66",
            "sms": {
                "to": "9**-2**-60**",
                "to_name": null,
                "from": "7**-7**-30**",
                "by": "Tu*** Acqu**"
            }
        },
        "user_account": {
            "username": "sm***",
            "first_name": "John",
            "last_name": "Smith",
            "email": "[e-mail]",
            "phone": null
        },
        "source": {
            "type": "api",
            "properties": {
                "api_name": "Tu** Staging"
            }
        },
        "vehicle": {
            "id": 446964,
            "session_key": "SMG-JLID***EVE",
            "vin": "5FNRL6H5*****1014",
            "vrm": null,
            "year": 2020,
            "make": "Honda",
            "model": "ODYSSEY",
            "body_type": "Sports Van",
            "trim": "EX Auto",
            "transmission": "AUTOMATIC",
            "drivetrain": "Front Wheel Drive",
            "engine_type": "3.5 L Regular Unleaded V-6",
            "fuel_type": null,
            "ext_col": "Crystal Black Pearl",
            "int_col": "Mocha",
            "odom_reading": "28050",
            "odom_unit": "MILES"
        }
    },
    "photos": [
        {
            "photo_code": 2,
            "photo_label": "Interior",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JL**DEKEVE\/capture\/2-9acb1658-cb6e-476a-974d-a6179ff2b65b-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:34:00+00:00",
            "updated_at": "2023-12-07T17:34:07+00:00"
        },
        {
            "photo_code": 3,
            "photo_label": "Cluster",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/capture\/3-9acb1661-a4c1-4aff-bffe-0f9f1db1d226-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:34:06+00:00",
            "updated_at": "2023-12-07T17:34:14+00:00"
        },
        {
            "photo_code": 4,
            "photo_label": "Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/4-9acb169b-97f3-4ccc-9ad3-4ff7b292e118-1920x1080.jpg",
            "approved": false,
            "approved_message": "REJECTED: Please recapture the photo, ensuring that the vehicle is fully in frame for this angle.",
            "rejection_code": "vehicle_is_not_in_frame",
            "created_at": "2023-12-07T17:34:44+00:00",
            "updated_at": "2023-12-07T17:35:10+00:00"
        },
        {
            "photo_code": 10,
            "photo_label": "Front_Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/10-9acb16bc-a31e-43c6-9306-e6a23098f3bf-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:05+00:00",
            "updated_at": "2023-12-07T17:35:16+00:00"
        },
        {
            "photo_code": 5,
            "photo_label": "Front",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/5-9acb16d0-e94e-4673-99f5-16c109f79aa8-1920x1080.jpg",
            "approved": false,
            "approved_message": "REJECTED: Wrong View",
            "rejection_code": "wrong_view",
            "created_at": "2023-12-07T17:35:19+00:00",
            "updated_at": "2023-12-07T17:35:31+00:00"
        },
        {
            "photo_code": 11,
            "photo_label": "Front_Right",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/11-9acb16d9-d688-4ce8-8155-98b3bfaadf8b-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:25+00:00",
            "updated_at": "2023-12-07T17:35:34+00:00"
        },
        {
            "photo_code": 7,
            "photo_label": "Right",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/7-9acb16df-56e7-4f64-a74f-0ca9b68c1614-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:29+00:00",
            "updated_at": "2023-12-07T17:35:38+00:00"
        },
        {
            "photo_code": 4,
            "photo_label": "Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDD**EVE\/capture\/4-9acb16f0-412c-479b-8328-4ecc2511b18c-1920x1080.jpg",
            "approved": false,
            "approved_message": "REJECTED: Please recapture the photo, ensuring that the vehicle is fully in frame for this angle.",
            "rejection_code": "vehicle_is_not_in_frame",
            "created_at": "2023-12-07T17:35:39+00:00",
            "updated_at": "2023-12-07T17:35:49+00:00"
        },
        {
            "photo_code": 12,
            "photo_label": "Rear_Right",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDD**EVE\/capture\/12-9acb1706-2ee3-4d14-80eb-90d308288d38-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:54+00:00",
            "updated_at": "2023-12-07T17:36:04+00:00"
        },
        {
            "photo_code": 5,
            "photo_label": "Front",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/5-9acb172b-f37e-4a87-8b60-621aa26a23db-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:36:20+00:00",
            "updated_at": "2023-12-07T17:36:34+00:00"
        },
        {
            "photo_code": 8,
            "photo_label": "Rear",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/8-9acb173d-f866-464f-8737-769ec9640e41-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:36:30+00:00",
            "updated_at": "2023-12-07T17:36:41+00:00"
        },
        {
            "photo_code": 4,
            "photo_label": "Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:36:46+00:00",
            "updated_at": "2023-12-07T17:36:56+00:00"
        },
        {
            "photo_code": 13,
            "photo_label": "Rear_Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/13-9acb176a-a8ce-4eb8-a2f8-e605b880e13f-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:37:00+00:00",
            "updated_at": "2023-12-07T17:37:11+00:00"
        },
        {
            "photo_code": 9,
            "photo_label": "Windshield",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/9-9acb179a-acf6-4981-8b21-6883e5a56cd6-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:37:31+00:00",
            "updated_at": "2023-12-07T17:37:47+00:00"
        },
        {
            "photo_code": 6,
            "photo_label": "Tires",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/6-9acb17a7-e30e-48f1-9f73-a8cbfcdb8d57-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:37:41+00:00",
            "updated_at": "2023-12-07T17:37:50+00:00"
        }
    ],
    "vehicle": {
        "id": 446964,
        "session_key": "SMG-JLID**EVE",
        "vin": "5FNRL6H51LB****14",
        "vrm": null,
        "year": 2020,
        "make": "Honda",
        "model": "ODYSSEY",
        "body_type": "Sports Van",
        "trim": "EX Auto",
        "transmission": "AUTOMATIC",
        "drivetrain": "Front Wheel Drive",
        "engine_type": "3.5 L Regular Unleaded V-6",
        "fuel_type": null,
        "ext_col": "Crystal Black Pearl",
        "int_col": "Mocha",
        "odom_reading": "28050",
        "odom_unit": "MILES"
    },
    "location": {
        "address": "****, KS, USA",
        "latitude": "37.7*1000000",
        "longitude": "-97.8*2000000",
        "street_num": "-",
        "street": "-",
        "city": "Cheney",
        "state": "Kansas",
        "state_code": "KS",
        "country_code": "US",
        "post_code": "11225",
        "country": "United States",
        "ip": null
    },
    "inspection": {
        "damages_overview": {
            "totalDamages": 13,
            "maxGradePerItem": 3,
            "maxTotalGrade": 10
        },
        "detected_damages": [
            {
                "damage_id": 1,
                "damage_group": "BODY",
                "component": "BUMPER_FRONT_UNIQUE",
                "damage_name": "SCRAPED_MAJOR",
                "component_label": "Front Bumper Cover",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Major Scrape",
                "description": "Scraped",
                "tolerance": "9 inches to 10 inches",
                "repair_method": "Repair & Refinish",
                "repair_type": "Minor Body Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 5.5,
                "labor_total": 412.5,
                "parts_materials": 250,
                "total": 662.5,
                "grade_score": 2,
                "frame_grade_score": 0,
                "photo": {
                    "code": "07",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/7-9acb16df-56e7-4f64-a74f-0ca9b68c1614-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.8984,
                    "y": 0.6573
                },
                "uuid": "g08lg3ulpvhgr3a",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JL**DEKEVE\/cropped\/07\/07-g08lg3ulpvhgr3a.jpg",
                "cropped_code": "1",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Heavy Scratch",
                "damage_type_id": 20,
                "aasc_damage_code": 81,
                "severity": "Major",
                "severity_id": 3,
                "aasc_severity_code": 15,
                "component_id": 14,
                "aasc_item_code": 6300
            },
            {
                "damage_id": 2,
                "damage_group": "BODY",
                "component": "BUMPER_FRONT_UNIQUE",
                "damage_name": "MULTIPLE_SCRATCHES_MAJOR_THROUGH_PAINT",
                "component_label": "Front Bumper Cover",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Multiple Major Scratches - Through Paint",
                "description": "Multiple Scratches Heavy",
                "tolerance": "10 or more heavy scratches",
                "repair_method": "Repair & Refinish",
                "repair_type": "Minor Body Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 5.5,
                "labor_total": 412.5,
                "parts_materials": 250,
                "total": 662.5,
                "grade_score": 2,
                "frame_grade_score": 0,
                "photo": {
                    "code": "05",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-**IDDEKEVE\/annotated\/5-9acb172b-f37e-4a87-8b60-621aa26a23db-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.231,
                    "y": 0.7051
                },
                "uuid": "4vhkulpvhh85l",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-**IDDEKEVE\/cropped\/05\/05-4vhkulpvhh85l.jpg",
                "cropped_code": "1",
                "estimate_included": true,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Heavy Mult Scratches",
                "damage_type_id": 19,
                "aasc_damage_code": 254,
                "severity": "Major Through Paint",
                "severity_id": 9,
                "aasc_severity_code": 66,
                "component_id": 14,
                "aasc_item_code": 6300
            },
            {
                "damage_id": 3,
                "damage_group": "BODY",
                "component": "BUMPER_FRONT_UNIQUE",
                "damage_name": "SCRAPED_MAJOR",
                "component_label": "Front Bumper Cover",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Major Scrape",
                "description": "Scraped",
                "tolerance": "9 inches to 10 inches",
                "repair_method": "Repair & Refinish",
                "repair_type": "Minor Body Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 5.5,
                "labor_total": 412.5,
                "parts_materials": 250,
                "total": 662.5,
                "grade_score": 2,
                "frame_grade_score": 0,
                "photo": {
                    "code": "05",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDD**EVE\/annotated\/5-9acb172b-f37e-4a87-8b60-621aa26a23db-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.2631,
                    "y": 0.8274
                },
                "uuid": "4vhkulpvhh85m",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/cropped\/05\/05-4vhkulpvhh85m.jpg",
                "cropped_code": "2",
                "estimate_included": true,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Heavy Scratch",
                "damage_type_id": 20,
                "aasc_damage_code": 81,
                "severity": "Major",
                "severity_id": 3,
                "aasc_severity_code": 15,
                "component_id": 14,
                "aasc_item_code": 6300
            },
            {
                "damage_id": 4,
                "damage_group": "PART",
                "component": "HOUSING_LIGHT_FOG_RIGHT",
                "damage_name": "BROKEN_MEDIUM",
                "component_label": "Right Fog Light Housing",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Medium Crack",
                "description": "Broken",
                "tolerance": "5 to 6 inches",
                "repair_method": "Replace",
                "repair_type": "Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "",
                "labor_hrs": 0,
                "labor_total": 0,
                "parts_materials": 0,
                "total": 0,
                "grade_score": 2,
                "frame_grade_score": 0,
                "photo": {
                    "code": "05",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-J**DDEKEVE\/annotated\/5-9acb172b-f37e-4a87-8b60-621aa26a23db-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.2803,
                    "y": 0.8167
                },
                "uuid": "4vhkulpvhh85n",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/cropped\/05\/05-4vhkulpvhh85n.jpg",
                "cropped_code": "3",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Textured Surface",
                "damage_type": "Broken",
                "damage_type_id": 2,
                "aasc_damage_code": 16,
                "severity": "Medium",
                "severity_id": 2,
                "aasc_severity_code": 10,
                "component_id": 68,
                "aasc_item_code": 8736
            },
            {
                "damage_id": 5,
                "damage_group": "BODY",
                "component": "BUMPER_REAR_UNIQUE",
                "damage_name": "SCRAPED_MINOR",
                "component_label": "Rear Bumper Cover",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Minor Scrape",
                "description": "Scraped",
                "tolerance": "1\/8 to 1\/2 inch - NAAA Acceptable",
                "repair_method": "Refinish",
                "repair_type": "SMART Repair",
                "unit_measure": "Per Item",
                "estimate_category": "Exterior",
                "labor_hrs": 2.5,
                "labor_total": 187.5,
                "parts_materials": 200,
                "total": 387.5,
                "grade_score": 1,
                "frame_grade_score": 0,
                "photo": {
                    "code": "08",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/8-9acb173d-f866-464f-8737-769ec9640e41-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.7078,
                    "y": 0.947
                },
                "uuid": "4vhkulpvhg318",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JL**DEKEVE\/cropped\/08\/08-4vhkulpvhg318.jpg",
                "cropped_code": "1",
                "estimate_included": true,
                "estimate_tbd": false,
                "material": "Textured Surface",
                "damage_type": "Heavy Scratch",
                "damage_type_id": 20,
                "aasc_damage_code": 81,
                "severity": "Minor",
                "severity_id": 1,
                "aasc_severity_code": 73,
                "component_id": 15,
                "aasc_item_code": 1420
            },
            {
                "damage_id": 6,
                "damage_group": "BODY",
                "component": "BUMPER_REAR_UNIQUE",
                "damage_name": "MULTIPLE_SCRATCHES_MINOR_THROUGH_PAINT",
                "component_label": "Rear Bumper Cover",
                "user_response": null,
                "admin_response": "add",
                "source": "inspect",
                "label": "Has Multiple Minor Scratches - Through Paint",
                "description": "Multiple Scratches Heavy",
                "tolerance": "2",
                "repair_method": "Refinish",
                "repair_type": "SMART Repair",
                "unit_measure": "Per Item",
                "estimate_category": "Exterior",
                "labor_hrs": 4,
                "labor_total": 300,
                "parts_materials": 550,
                "total": 850,
                "grade_score": 1,
                "frame_grade_score": 0,
                "photo": {
                    "code": "08",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/8-9acb173d-f866-464f-8737-769ec9640e41-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.7364,
                    "y": 0.8751
                },
                "uuid": "g08lg3ulpvhjdl8",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/cropped\/08\/08-g08lg3ulpvhjdl8.jpg",
                "cropped_code": "2",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Heavy Mult Scratches",
                "damage_type_id": 19,
                "aasc_damage_code": 254,
                "severity": "Minor Through Paint",
                "severity_id": 7,
                "aasc_severity_code": 52,
                "component_id": 15,
                "aasc_item_code": 1420
            },
            {
                "damage_id": 7,
                "damage_group": "BODY",
                "component": "HATCH_REAR_UNIQUE",
                "damage_name": "DENT_MAJOR_SEAM_LINE",
                "component_label": "Rear Hatch",
                "user_response": null,
                "admin_response": "add",
                "source": "inspect",
                "label": "Has Major Dent on Seam Line - Not Through Paint",
                "description": "Has Major Dent on Seam Line - Not Through Paint",
                "tolerance": "Major dent 9 - 10 inches but on seam line",
                "repair_method": "Replace",
                "repair_type": "SMART Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 9,
                "labor_total": 675,
                "parts_materials": 850,
                "total": 1525,
                "grade_score": 3,
                "frame_grade_score": 0,
                "photo": {
                    "code": "08",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/annotated\/8-9acb173d-f866-464f-8737-769ec9640e41-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.6843,
                    "y": 0.7756
                },
                "uuid": "g08lg3ulpvhjdl9",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/cropped\/08\/08-g08lg3ulpvhjdl9.jpg",
                "cropped_code": "3",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Mult Dents\/Paint Damage",
                "damage_type_id": 30,
                "aasc_damage_code": 257,
                "severity": "Major",
                "severity_id": 3,
                "aasc_severity_code": 66,
                "component_id": 56,
                "aasc_item_code": 423
            },
            {
                "damage_id": 8,
                "damage_group": "BODY",
                "component": "BUMPER_FRONT_UNIQUE",
                "damage_name": "SCRATCH_MINOR_NOT_THROUGH_PAINT",
                "component_label": "Front Bumper Cover",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Minor Scratch - Not Through Paint",
                "description": "Light Scratch",
                "tolerance": "1\/8 to 1\/2 inch - NAAA Acceptable",
                "repair_method": "Refinish",
                "repair_type": "SMART Repair",
                "unit_measure": "Per Item",
                "estimate_category": "Exterior",
                "labor_hrs": 4.5,
                "labor_total": 337.5,
                "parts_materials": 200,
                "total": 537.5,
                "grade_score": 1,
                "frame_grade_score": 0,
                "photo": {
                    "code": "04",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/annotated\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.1532,
                    "y": 0.5151
                },
                "uuid": "4vhkulpvhgf3t",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/cropped\/04\/04-4vhkulpvhgf3t.jpg",
                "cropped_code": "1",
                "estimate_included": true,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Scratch Light",
                "damage_type_id": 40,
                "aasc_damage_code": 73,
                "severity": "Minor Not Through Paint",
                "severity_id": 4,
                "aasc_severity_code": 73,
                "component_id": 14,
                "aasc_item_code": 6300
            },
            {
                "damage_id": 9,
                "damage_group": "BODY",
                "component": "DOOR_REAR_LEFT",
                "damage_name": "SCRATCH_MINOR_NOT_THROUGH_PAINT",
                "component_label": "Rear Left Door",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Has Minor Scratch - Not Through Paint",
                "description": "Light Scratch",
                "tolerance": "1\/8 to 1\/2 inch - NAAA Acceptable",
                "repair_method": "Refinish",
                "repair_type": "SMART Repair",
                "unit_measure": "Per Item",
                "estimate_category": "Exterior",
                "labor_hrs": 4,
                "labor_total": 300,
                "parts_materials": 200,
                "total": 500,
                "grade_score": 1,
                "frame_grade_score": 0,
                "photo": {
                    "code": "04",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0.6406,
                    "y": 0.4367
                },
                "uuid": "4vhkulpvhggxt",
                "cropped_url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/cropped\/04\/04-4vhkulpvhggxt.jpg",
                "cropped_code": "2",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Scratch Light",
                "damage_type_id": 40,
                "aasc_damage_code": 73,
                "severity": "Minor Not Through Paint",
                "severity_id": 4,
                "aasc_severity_code": 73,
                "component_id": 29,
                "aasc_item_code": 220
            },
            {
                "damage_id": 10,
                "damage_group": "TIRE",
                "component": "TIRE_FRONT_LEFT",
                "damage_name": "WORN_MAJOR",
                "component_label": "Front Left Tire",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Is Majorly Worn",
                "description": "Is Majorly Worn",
                "tolerance": "Shows Major Wear",
                "repair_method": "Replace",
                "repair_type": "Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0.5,
                "labor_total": 37.5,
                "parts_materials": 175,
                "total": 212.5,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "04",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0,
                    "y": 0
                },
                "uuid": "g08lg3ulpvhfxs0",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "Worn",
                "damage_type_id": 54,
                "aasc_damage_code": 10,
                "severity": "Major Tire Wear",
                "severity_id": 12,
                "aasc_severity_code": 71,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_id": 11,
                "damage_group": "TIRE",
                "component": "TIRE_REAR_LEFT",
                "damage_name": "WORN_MAJOR",
                "component_label": "Rear Left Tire",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Is Majorly Worn",
                "description": "Is Majorly Worn",
                "tolerance": "Shows Major Wear",
                "repair_method": "Replace",
                "repair_type": "Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0.5,
                "labor_total": 37.5,
                "parts_materials": 175,
                "total": 212.5,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "04",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0,
                    "y": 0
                },
                "uuid": "g08lg3ulpvhfxs1",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "Worn",
                "damage_type_id": 54,
                "aasc_damage_code": 10,
                "severity": "Major Tire Wear",
                "severity_id": 12,
                "aasc_severity_code": 71,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_id": 12,
                "damage_group": "TIRE",
                "component": "TIRE_REAR_RIGHT",
                "damage_name": "WORN_MAJOR",
                "component_label": "Rear Right Tire",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Is Majorly Worn",
                "description": "Is Majorly Worn",
                "tolerance": "Shows Major Wear",
                "repair_method": "Replace",
                "repair_type": "Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0.5,
                "labor_total": 37.5,
                "parts_materials": 175,
                "total": 212.5,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "07",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/7-9acb16df-56e7-4f64-a74f-0ca9b68c1614-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0,
                    "y": 0
                },
                "uuid": "g08lg3ulpvhfxs2",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "Worn",
                "damage_type_id": 54,
                "aasc_damage_code": 10,
                "severity": "Major Tire Wear",
                "severity_id": 12,
                "aasc_severity_code": 71,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_id": 13,
                "damage_group": "TIRE",
                "component": "TIRE_FRONT_RIGHT",
                "damage_name": "WORN_MAJOR",
                "component_label": "Front Right Tire",
                "user_response": null,
                "admin_response": null,
                "source": "inspect",
                "label": "Is Majorly Worn",
                "description": "Is Majorly Worn",
                "tolerance": "Shows Major Wear",
                "repair_method": "Replace",
                "repair_type": "Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0.5,
                "labor_total": 37.5,
                "parts_materials": 175,
                "total": 212.5,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "07",
                    "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/7-9acb16df-56e7-4f64-a74f-0ca9b68c1614-1920x1080.jpg"
                },
                "coodrs": {
                    "x": 0,
                    "y": 0
                },
                "uuid": "g08lg3ulpvhfxs3",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "Worn",
                "damage_type_id": 54,
                "aasc_damage_code": 10,
                "severity": "Major Tire Wear",
                "severity_id": 12,
                "aasc_severity_code": 71,
                "component_id": 0,
                "aasc_item_code": 0
            }
        ],
        "estimates": {
            "total_exterior": 3537.5,
            "total_wheels_and_tires": 850,
            "total_excess_wear": 4387.5,
            "currency": "USD"
        },
        "detected_status": {
            "interior_status": "CLEAN",
            "wheels": {
                "wheel_rear_left": "Alloy Wheel",
                "wheel_front_left": "Alloy Wheel",
                "wheel_rear_right": "Alloy Wheel",
                "wheel_front_right": "Alloy Wheel"
            }
        },
        "grading": {
            "standard_A": 3,
            "standard_B": "C-3",
            "standard_C": "Fair Condition",
            "repair_estimate": {
                "total_exterior": 3537.5,
                "total_wheels_and_tires": 850,
                "total_excess_wear": 4387.5,
                "currency": "USD"
            }
        },
        "annotated_images": [
            {
                "photo_code": "04",
                "photo_label": "Left",
                "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg"
            },
            {
                "photo_code": "05",
                "photo_label": "Front",
                "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/5-9acb172b-f37e-4a87-8b60-621aa26a23db-1920x1080.jpg"
            },
            {
                "photo_code": "07",
                "photo_label": "Right",
                "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/7-9acb16df-56e7-4f64-a74f-0ca9b68c1614-1920x1080.jpg"
            },
            {
                "photo_code": "08",
                "photo_label": "Rear",
                "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/annotated\/8-9acb173d-f866-464f-8737-769ec9640e41-1920x1080.jpg"
            }
        ],
        "case_details": {
            "case_start_time": false,
            "case_end_time": false
        }
    },
    "condition_report": "https:\/\/reports.paveapi.com\/api\/report\/SMG-JLI**EKEVE",
    "landing_page": "https:\/\/dashboard.paveapi.com\/park\/SMG-JLI**EKEVE\/?l=en",
    "disclosures": null,
    "announcements": null,
    "seller_tires": null,
    "forms": null
}

Sample Response (302: Found)

The session is not yet COMPLETE and might be in IDLE or PROCESSING status, and the final results are not available. See the Webhooks section to learn more about PAVE session statuses.

{
    "message": "Session is not yet completed."
}

Sample Response (404: Not Found)

The session does not exist, please check the :session_key.

{
    "message": "Session :session_key cannot be found."
}

Session Objects

Attribute	Type	Description
session_key	string	Session Key generated for User
theme	string	Theme provided to use for User Interface
active	string	Results status
status	string	Session status
redirect_url	string	URL provided to send User when the session completes
inspect_started_at	datetime	UTC Datetime for when User started the session
inspect_ended_at	datetime	UTC Datetime for when User finished the session
created_at	datetime	UTC Datetime for when session_key was created
updated_at	datetime	UTC Datetime for when session_key was updated
language	string	Language provided to use for User Interface

options

sms

Attribute	Type	Description
to	string	Destination mobile phone number provided to send to User
to_name	string	The name that was inputted as the Contact Name on the form or request.
from	string	Destination mobile phone number provided to send final results
by	string	Name provided to include in SMS Message sent to User

    "session": {
        "session_key": "XXX-ABCDE12345",
        "theme": "PRO",
        "active": true,
        "status": "COMPLETE",
        "redirect_url": "https://dev.paveinspect.com/valet/XXX-ABCDE12345/?l=en",
        "inspect_started_at": "2021-05-25T11:51:49.000000Z",
        "inspect_ended_at": "2021-05-25T11:56:05.000000Z",
        "created_at": "2021-05-25T11:50:49.000000Z",
        "updated_at": "2021-05-25T11:59:20.000000Z",
        "language": "EN",
        "options": {
            "sms": {
                "to": "647-455-XXXX",
                "to_name": "Jane Smith",
                "from": "647-422-XXXX",
                "by": "Steve's Test Dealer",
            }

Photos

Attribute	Type	Descriptionphotointeger
photo_code	integer	PAVE's system code for each photo
photo_label	string	Describes the content of the photo
url	string	URL to retrieve photo
approved	string	Was the photo rejected or approved
approved_message	string	ACCEPTED or REJECTED with the reason why
rejection_code	string	Rejection Code for that specific approved_message
created_at	datetime	UTC Datetime for when the photo was captured
updated_at	datetime	UTC Datetime for when the photo status was last updated

  },
    "photos": [
        {
            "photo_code": 2,
            "photo_label": "Interior",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JL**DEKEVE\/capture\/2-9acb1658-cb6e-476a-974d-a6179ff2b65b-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:34:00+00:00",
            "updated_at": "2023-12-07T17:34:07+00:00"
        },
        {
            "photo_code": 3,
            "photo_label": "Cluster",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/capture\/3-9acb1661-a4c1-4aff-bffe-0f9f1db1d226-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:34:06+00:00",
            "updated_at": "2023-12-07T17:34:14+00:00"
        },
        {
            "photo_code": 4,
            "photo_label": "Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/4-9acb169b-97f3-4ccc-9ad3-4ff7b292e118-1920x1080.jpg",
            "approved": false,
            "approved_message": "REJECTED: Please recapture the photo, ensuring that the vehicle is fully in frame for this angle.",
            "rejection_code": "vehicle_is_not_in_frame",
            "created_at": "2023-12-07T17:34:44+00:00",
            "updated_at": "2023-12-07T17:35:10+00:00"
        },
        {
            "photo_code": 10,
            "photo_label": "Front_Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/10-9acb16bc-a31e-43c6-9306-e6a23098f3bf-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:05+00:00",
            "updated_at": "2023-12-07T17:35:16+00:00"
        },
        {
            "photo_code": 5,
            "photo_label": "Front",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/5-9acb16d0-e94e-4673-99f5-16c109f79aa8-1920x1080.jpg",
            "approved": false,
            "approved_message": "REJECTED: Wrong View",
            "rejection_code": "wrong_view",
            "created_at": "2023-12-07T17:35:19+00:00",
            "updated_at": "2023-12-07T17:35:31+00:00"
        },
        {
            "photo_code": 11,
            "photo_label": "Front_Right",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/11-9acb16d9-d688-4ce8-8155-98b3bfaadf8b-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:25+00:00",
            "updated_at": "2023-12-07T17:35:34+00:00"
        },
        {
            "photo_code": 7,
            "photo_label": "Right",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDDEKEVE\/capture\/7-9acb16df-56e7-4f64-a74f-0ca9b68c1614-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:29+00:00",
            "updated_at": "2023-12-07T17:35:38+00:00"
        },
        {
            "photo_code": 4,
            "photo_label": "Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDD**EVE\/capture\/4-9acb16f0-412c-479b-8328-4ecc2511b18c-1920x1080.jpg",
            "approved": false,
            "approved_message": "REJECTED: Please recapture the photo, ensuring that the vehicle is fully in frame for this angle.",
            "rejection_code": "vehicle_is_not_in_frame",
            "created_at": "2023-12-07T17:35:39+00:00",
            "updated_at": "2023-12-07T17:35:49+00:00"
        },
        {
            "photo_code": 12,
            "photo_label": "Rear_Right",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLIDD**EVE\/capture\/12-9acb1706-2ee3-4d14-80eb-90d308288d38-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:35:54+00:00",
            "updated_at": "2023-12-07T17:36:04+00:00"
        },
        {
            "photo_code": 5,
            "photo_label": "Front",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/5-9acb172b-f37e-4a87-8b60-621aa26a23db-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:36:20+00:00",
            "updated_at": "2023-12-07T17:36:34+00:00"
        },
        {
            "photo_code": 8,
            "photo_label": "Rear",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/8-9acb173d-f866-464f-8737-769ec9640e41-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:36:30+00:00",
            "updated_at": "2023-12-07T17:36:41+00:00"
        },
        {
            "photo_code": 4,
            "photo_label": "Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/4-9acb1756-4114-4bf4-8c81-f8dc3dcaaa50-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:36:46+00:00",
            "updated_at": "2023-12-07T17:36:56+00:00"
        },
        {
            "photo_code": 13,
            "photo_label": "Rear_Left",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLID**KEVE\/capture\/13-9acb176a-a8ce-4eb8-a2f8-e605b880e13f-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:37:00+00:00",
            "updated_at": "2023-12-07T17:37:11+00:00"
        },
        {
            "photo_code": 9,
            "photo_label": "Windshield",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/capture\/9-9acb179a-acf6-4981-8b21-6883e5a56cd6-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:37:31+00:00",
            "updated_at": "2023-12-07T17:37:47+00:00"
        },
        {
            "photo_code": 6,
            "photo_label": "Tires",
            "url": "https:\/\/openapi-cdn.paveapi.com\/sessions\/sessions\/2023-12\/SMG-JLI**EKEVE\/capture\/6-9acb17a7-e30e-48f1-9f73-a8cbfcdb8d57-1920x1080.jpg",
            "approved": true,
            "approved_message": "Accepted",
            "rejection_code": null,
            "created_at": "2023-12-07T17:37:41+00:00",
            "updated_at": "2023-12-07T17:37:50+00:00"
        }

List of Rejection Codes

approved_message (string)	rejection_code (string)
REJECTED: Door is open - please close and recapture	"rejection_code": "opened_door"​
REJECTED: Image Not Clear	"rejection_code": "image_not_clear"​
REJECTED: Make sure your plate number is visible in the photo provided	"rejection_code": "vrm_not_visible"​
REJECTED: Please recapture the photo, ensuring that the vehicle is fully in frame for this angle.	"rejection_code": "vehicle_is_not_in_frame​"
REJECTED: The Vehicle does not match our previous inspection records for this VIN.	"rejection_code": "mismatched_record"​
REJECTED: Too Dark	"rejection_code": "too_dark"​
REJECTED: Too Sunny	"rejection_code": too_sunny"​
REJECTED: View is obstructed, please recapture photo.	"rejection_code": "view_is_obstructed"​
REJECTED: We are having trouble reading your Odometer, please recapture Odometer photo.	"rejection_code": "no_odometer​"
REJECTED: Wrong View	"rejection_code": "wrong_view"​
REJECTED: Bad Weather	"rejection_code": "bad_weather"​
REJECTED: Make sure your VIN is visible in the VIN photo provided	"rejection_code": "vin_not_visible"​
REJECTED: Vehicle in photo does not match VIN provided or vehicle being inspected.	"rejection_code": "vin_mismatch"​
REJECTED: Please only capture your VIN from off the vehicle itself	"rejection_code": "vin_not_from_vehicle"
"Accepted"	"rejection_code": null

Note:

Since the VIN photo (Photo Code: 1) routes the data through PAVE's Capture API instead of the OpenAPI, the VIN photo will always show "rejection_code": null

Vehicle Objects

Attribute	Type	Description
vehicle_id	integer	PAVE system ID for vehicle
vin	string	The VIN inputted or extracted for the session
year	integer	The Year of the vehicle
make	string	The Make of the vehicle
model	string	The Model of the vehicle
body_type	string	The vehicle's body type
trim	string	The Trim detected of the vehicle
transmission	string	The Transmission detected for the vehicle
drivetrain	string	The Drivetrain of the vehicle
engine_type	string	The Engine Type of the vehicle
fuel_type	string	The Fuel Type of the vehicle
ext_col	string	The Exterior Color detected of the vehicle
int_col	string	The Interior Color detected of the vehicle
odom_reading	integer	The Odometer Reading inputted or extracted for the session
odom_unit	string	The Odometer unit of measure inputted or extracted for the session

    "vehicle": {
        "id": 19880,
        "vin": "5N1AT2MV0HCXXXXXX",
        "year": 2017,
        "make": "Nissan",
        "model": "Rogue",
        "body_type": "Wagon 4 Dr.",
        "trim": "AWD 4dr S *Ltd Avail*",
        "transmission": "AUTOMATIC",
        "drivetrain": "All Wheel Drive",
        "engine_type": "4 Cylinder Engine",
        "fuel_type": "Gasoline Fuel",
        "ext_col": "Glacier White",
        "int_col": "Black",
        "odom_reading": "100,945",
        "odom_unit": "KILOMETRES"
    },

Location

Attribute	Type	Description
address	string	Full address of where the vehicle was inspected
street_num	integer	Street Number
street	string	Street
city	string	City
state	string	State or Province
state_code	string	ZIP or Postal Code
country	string	Name of Country
country_code	string	ISO Country Code
latitude	string	Latitude
longitude	string	Longitude

The PAVE Capture UI detects the User's location for where they completed their inspection only when they give PAVE permission when asked by the browser. This location is not always their business or home address as it is the inspection location and may not be available for all sessions. When the User gives permission but they have not set the browser to share their location in their device settings PAVE will not return the location.

    "location": {
        "address": "3 Sloping Sky Mews, Toronto, ON M5V 0B9, Canada",
        "street_num": "3",
        "street": "Sloping Sky Mews",
        "city": "Toronto",
        "state": "Ontario",
        "state_code": "ON",
        "post_code": "M5V 0B9",
        "country": "Canada",
        "country_code": "CA",
        "latitude": "43.636662757",
        "longitude": "-79.403777518"
    }

Disclosures

Attribute	Type	Description
title_orgin	object	User responses to Title questions
odometer	object	User responses to Odometer questions
damage	object	User responses to Damage questions
mechanical	object	User responses to Mechanical questions
previous_user	object	User responses to Previous Use questions

    "disclosures": {
        "title_origin": {
            "grey_market": false,
            "incorrect_vehicle_marking": false,
            "manufacturer_repurchase": [],
            "out_of_state": [],
            "title_branded": "None",
            "total_loss": false,
            "cross_boarder": false,
            "vin_plate_issues": false,
            "warranty_cancelled": false,
            "stolen_and_recovered": false
        },
        "odometer": {
            "odom_5_digit": false,
            "odom_faulty": false,
            "odom_in_other": false,
            "odom_replaced": false,
            "odom_roll_back": false,
            "odom_unreadable": false,
            "tmu": false,
            "rmu": []
        },
        "damage": {
            "accident_repair": 0,
            "adjacent_panels_replaced": false,
            "excessive_rust": false,
            "fire_damage": false,
            "flood_damage": false,
            "irreparable": false,
            "structural_damage": false
        },
        "mechanical": {
            "abs_defective": false,
            "air_bag_defective": false,
            "alternate_fuel": false,
            "none_specs": false,
            "major_repair": []
        },
        "previous_user": {
            "previous_daily_rental": false,
            "previous_driving_school_vehicle": false,
            "previous_emergency_vehicle": false,
            "previous_police_vehicle": false,
            "previous_taxi_limo": false
        }
    },

Announcements

Attribute	Type	Description
title_present	boolean	User response to is Title Present
all_keys_present	integer	Number of keys response from User
books_present	boolean	User response to are Books Present
discs_present	boolean	User response to are all Discs Present
rims_tires	boolean	User response to are Original Rims and Tires Present
other_announcements	string	User-added announcements

    "announcements": {
        "title_present": null,
        "all_keys_present": "1",
        "books_present": true,
        "discs_present": true,
        "rims_tires": false,
        "other_announcements": "qc test"
    },

Inspection Objects

detected_status

The detected_status provides a label that describes the condition that was determined by the inspection of the vehicle's interior and tires.

Attribute	Type	Description
interior	string	PAVE Label that describes the overall interior condition
tire	string	PAVE Label that describes the condition of the tires

detected_damages

The detected_damages provides the detail that describes the damages detected during the inspection.

Attribute	Type	Description
damage_group	string	The category of the damaged component type
component	string	The label of the component that is damaged
damage_name	string	The label of the damage type that was detected
component_label	string	The description of the component that is damaged
user_response	string	If the User accepted or denied the detected damages
source	string	If the damage was detected by PAVE or inputted manually
description	string	The description of the damage detected
tolerance	string	The tolerance range of the detected damage label used
repair_method	string	The method used to repair the damage
repair_type	string	The category of the type of repair
unit_measure	string	If the repair fixes all other damages or not (Per Item does not)
grade_score	integer	The level of severity as a score from 0-5
frame_grade_score	integer	The added level of severity if considered frame damage
photo: code	integer	The PAVE code for the image
photo: url	string	The URL to retrieve the image that was used to detect damage
uuid	string	PAVE's damage ID
cropped_url	string	The URL to retrieve the cropped image of the damage
cropped_code	integer	The number that is used identify the location of the damage on the annotated image
estimate_category	string	The category of estimate between Exterior and Tire/Wheel
labor_hrs	integer	Labor hour estimate to handle the damage
labor_total	integer	Labor total cost to handle the damage: Standard Labor Rate * Labor hour
part_materials	integer	Estimate cost of the damaged component that need repair/replace
total	integer	Total estimate cost: Labor + Part
estimate_included	boolean	Indicate if the cost of this component is already included in another damage report
estimate_tbd	boolean	Indicate if the cost of this component can be discussed between users
material	string	Material of the component
component_id	integer	PAVE ID of component
damage_type	string	Damage type that was detected
damage_type_id	integer	PAVE ID of damage type
severity	string	Severity of damage detected
severity_id	integer	PAVE ID of severity
aasc_item_code	integer	AutoGrade component code
aasc_damage_code	integer	AutoGrade damage code
aasc_severity_code	integer	AutoGrade severity code

        "detected_damages": [
            {
                "damage_group": "BODY",
                "component": "HOOD_FRONT_UNIQUE",
                "damage_name": "BENT_MAJOR",
                "component_label": "Hood",
                "user_response": null,
                "source": "inspect",
                "label": "Has Major Bend",
                "description": "Has Major Bend",
                "tolerance": "9 inches to 10 inches",
                "repair_method": "Replace",
                "repair_type": "Body Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 1,
                "labor_total": 1,
                "parts_materials": 1,
                "total": 2,
                "grade_score": 3,
                "frame_grade_score": 0,
                "photo": {
                    "code": "05",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/05\/05-annotated.jpg"
                },
                "uuid": "8lwjqg15lepjogtg",
                "cropped_url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/crop-damages\/8lwjqg15lepjogtg.png",
                "cropped_code": "01",
                "estimate_included": false,
                "estimate_tbd": false,
                "": "Painted",
                "damage_type": "Bent",
                "damage_type_id": 1,
                "aasc_damage_code": 15,
                "severity": "Major",
                "severity_id": 3,
                "aasc_severity_code": 15,
                "component_id": 64,
                "aasc_item_code": 110
            },
            {
                "damage_group": "BODY",
                "component": "BUMPER_FRONT_UNIQUE",
                "damage_name": "BENT_MEDIUM",
                "component_label": "Front Bumper Cover",
                "user_response": null,
                "source": "inspect",
                "label": "Has Medium Bend",
                "description": "Has Medium Bend",
                "tolerance": "5 to 6 inches",
                "repair_method": "Replace",
                "repair_type": "Body Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 3.5,
                "labor_total": 3.5,
                "parts_materials": 550,
                "total": 553.5,
                "grade_score": 3,
                "frame_grade_score": 0,
                "photo": {
                    "code": "05",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/05\/05-annotated.jpg"
                },
                "uuid": "8lwjqg15lepjogth",
                "cropped_url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/crop-damages\/8lwjqg15lepjogth.png",
                "cropped_code": "02",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Bent",
                "damage_type_id": 1,
                "aasc_damage_code": 15,
                "severity": "Medium",
                "severity_id": 2,
                "aasc_severity_code": 10,
                "component_id": 14,
                "aasc_item_code": 6300
            },
            {
                "damage_group": "BODY",
                "component": "BUMPER_FRONT_UNIQUE",
                "damage_name": "BROKEN_MEDIUM",
                "component_label": "Front Bumper Cover",
                "user_response": null,
                "source": "inspect",
                "label": "Has Medium Crack",
                "description": "Has Medium Crack",
                "tolerance": "5 to 6 inches",
                "repair_method": "Replace",
                "repair_type": "Body Shop Repair",
                "unit_measure": "Per Component",
                "estimate_category": "Exterior",
                "labor_hrs": 3.5,
                "labor_total": 3.5,
                "parts_materials": 550,
                "total": 553.5,
                "grade_score": 3,
                "frame_grade_score": 0,
                "photo": {
                    "code": "05",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/05\/05-annotated.jpg"
                },
                "uuid": "8lwjqg15lepjogti",
                "cropped_url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/crop-damages\/8lwjqg15lepjogti.png",
                "cropped_code": "03",
                "estimate_included": true,
                "estimate_tbd": false,
                "material": "Painted",
                "damage_type": "Broken",
                "damage_type_id": 2,
                "aasc_damage_code": 16,
                "severity": "Medium",
                "severity_id": 2,
                "aasc_severity_code": 10,
                "component_id": 14,
                "aasc_item_code": 6300
            },
            {
                "damage_group": "TIRE",
                "component": "TIRE_REAR_LEFT",
                "damage_name": "GOOD_CONDITION",
                "component_label": "Rear Left Tire",
                "user_response": null,
                "source": "inspect",
                "label": "Good Condition",
                "description": "Good Condition",
                "tolerance": "Shows Minimum Signs of Wear",
                "repair_method": "Info\/Report",
                "repair_type": "Info\/Report",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0,
                "labor_total": 0,
                "parts_materials": 0,
                "total": 0,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "04",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/04\/04-annotated.jpg"
                },
                "uuid": "3o4nq15lepjn3xs",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "GOOD_CONDITION",
                "damage_type_id": 0,
                "aasc_damage_code": 0,
                "severity": "",
                "severity_id": 0,
                "aasc_severity_code": 0,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_group": "TIRE",
                "component": "TIRE_REAR_RIGHT",
                "damage_name": "GOOD_CONDITION",
                "component_label": "Rear Right Tire",
                "user_response": null,
                "source": "inspect",
                "label": "Good Condition",
                "description": "Good Condition",
                "tolerance": "Shows Minimum Signs of Wear",
                "repair_method": "Info\/Report",
                "repair_type": "Info\/Report",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0,
                "labor_total": 0,
                "parts_materials": 0,
                "total": 0,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "07",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/07\/07-annotated.jpg"
                },
                "uuid": "3o4nq15lepjn3xt",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "GOOD_CONDITION",
                "damage_type_id": 0,
                "aasc_damage_code": 0,
                "severity": "",
                "severity_id": 0,
                "aasc_severity_code": 0,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_group": "TIRE",
                "component": "TIRE_FRONT_LEFT",
                "damage_name": "WORN_MINOR",
                "component_label": "Front Left Tire",
                "user_response": null,
                "source": "inspect",
                "label": "Is Minor Worn",
                "description": "Is Minor Worn",
                "tolerance": "Minor Signs of Wear",
                "repair_method": "Info\/Report",
                "repair_type": "Info\/Report",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0,
                "labor_total": 0,
                "parts_materials": 0,
                "total": 0,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "04",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/04\/04-annotated.jpg"
                },
                "uuid": "3o4nq15lepjn3y7",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "Worn",
                "damage_type_id": 54,
                "aasc_damage_code": 10,
                "severity": "Minor Tire Wear",
                "severity_id": 10,
                "aasc_severity_code": 16,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_group": "INTERIOR",
                "component": "INTERIOR",
                "damage_name": "CLEAN",
                "component_label": "Interior",
                "user_response": null,
                "source": "inspect",
                "label": "",
                "description": "",
                "tolerance": "",
                "repair_method": "",
                "repair_type": "",
                "unit_measure": "",
                "estimate_category": "",
                "labor_hrs": 0,
                "labor_total": 0,
                "parts_materials": 0,
                "total": 0,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "02",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/02\/02-original_ACCEPT_3134994.jpg"
                },
                "uuid": "3o4nq15lepjmad1",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "",
                "damage_type": "",
                "damage_type_id": 0,
                "aasc_damage_code": 0,
                "severity": "",
                "severity_id": 0,
                "aasc_severity_code": 0,
                "component_id": 0,
                "aasc_item_code": 0
            },
            {
                "damage_group": "TIRE",
                "component": "TIRE_FRONT_RIGHT",
                "damage_name": "WORN_MINOR",
                "component_label": "Front Right Tire",
                "user_response": null,
                "source": "inspect",
                "label": "Is Minor Worn",
                "description": "Is Minor Worn",
                "tolerance": "Minor Signs of Wear",
                "repair_method": "Info\/Report",
                "repair_type": "Info\/Report",
                "unit_measure": "Per Component",
                "estimate_category": "Tires and Wheels",
                "labor_hrs": 0,
                "labor_total": 0,
                "parts_materials": 0,
                "total": 0,
                "grade_score": 0,
                "frame_grade_score": 0,
                "photo": {
                    "code": "07",
                    "url": "https:\/\/inspections.paveapi.com\/PAV-230301103619-113\/07\/07-annotated.jpg"
                },
                "uuid": "3o4nq15lepjn3y8",
                "cropped_url": "",
                "cropped_code": "",
                "estimate_included": false,
                "estimate_tbd": false,
                "material": "Rubber",
                "damage_type": "Worn",
                "damage_type_id": 54,
                "aasc_damage_code": 10,
                "severity": "Minor Tire Wear",
                "severity_id": 10,
                "aasc_severity_code": 16,
                "component_id": 0,
                "aasc_item_code": 0
            }
        ]

Annotated Images

The annotated_imagesprovides the URLs to retrieve the images PAVE generates that are annotated to highlight the exact location of all the detected damages. The highlighted number corresponds with the cropped_codenumber found in the damagesobject. These will be NULL if no damages are found.

        "annotated_images": [
            {"photo_code": 4, "photo_label": "Left", "url": "https://inspections-dev.paveapi.com/PAV-210525115647-178/04/04-annotated.jpg"},
            {"photo_code": 5, "photo_label": "Front", "url": "https://inspections-dev.paveapi.com/PAV-210525115647-178/05/05-annotated.jpg"}
        ],

Grading

The grading provides the overall grading that PAVE has given the session vehicle based on what damages are detected. These gradings are given in three separate grading bands to help align with industry standards in each region or use case.

        "grading": {
            "standard_A": 4,
            "standard_B": "B-2",
            "standard_C": "Very Good Condition",

PAVE GRADING MATRIX:
STANDARD A	STANDARD B	STANDARD C
PAVE Vehicle Condition Grading Scale	NAMA Vehicle Condition Grading Scale http://www.nama-uk.com/	PAVE Book Value Grading Scale		vs Autograde	vs KBB	vs Black Book
5	A-1	Excellent Condition		Extra Clean	Excellent Condition	Extra Clean
4	B-2	Very Good Condition		Clean	Very Good Condition	Clean
3	C-3	Good Condition		Average	Good Condition	Average
2	D-4	Fair Condition		Below Average	Fair Condition	Rough
1	E-5	Poor Condition		Rough	Unclassified	Rough
0	U-6	Very Poor Condition		Unclassified	Unclassified	Rough

Component Damages

The component_damages provides an overall summary of how many items were detected per component and what the total estimates were for the session.

            "component_damages": {
                "DOOR_FRONT_LEFT": {
                    "score_by_component": false,
                    "item_score": 1,
                    "component_score": 0
                },
                "BUMPER_FRONT_UNIQUE": {
                    "score_by_component": false,
                    "item_score": 1,
                    "component_score": 0
                },
                "TIRE_FRONT_LEFT": {
                    "score_by_component": false,
                    "item_score": 0,
                    "component_score": 0
                },
                "TIRE_REAR_LEFT": {
                    "score_by_component": false,
                    "item_score": 0,
                    "component_score": 0
                },
                "TIRE_FRONT_RIGHT": {
                    "score_by_component": false,
                    "item_score": 0,
                    "component_score": 0
                },
                "TIRE_REAR_RIGHT": {
                    "score_by_component": false,
                    "item_score": 0,
                    "component_score": 0
                }
            }
        },
        "total_estimates": 2       
    },

Condition Report and Landing Page

When each session gets completed PAVE will generate two detailed condition reports; one as a sharable PDF and the other as an HTML landing page that you can use for your purposes. Your PAVE account representative can help to customize the header of both to fit your brand needs.

"condition_report": "https://reports.paveapi.com/api/report/XXX-ABCDE12345",
    "landing_page": "https://paveinspect.com/park/XXX-ABCDE12345"