Get inspection findings

GET

https://api.xapichina.com

cars

{car_id}

inspection

Get inspection findings and report links

curl --request GET \
  --url https://api.xapichina.com/v1/cars/{car_id}/inspection \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.xapichina.com/v1/cars/{car_id}/inspection', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "available": false,
  "inspection_report_url": "<string>",
  "report_type": "inspection",
  "data_available": false,
  "parse_status": "not_available",
  "report_provider": "<string>",
  "conclusions": [
    {
      "topic": "<string>",
      "label": "<string>",
      "source_label": "<string>",
      "source_fields": {}
    }
  ],
  "categories": [
    {
      "name": "<string>",
      "source_name": "<string>",
      "source_summary": "<string>",
      "reported_counts": {},
      "parsed_item_count": 0,
      "count_matches": true,
      "items": [
        {
          "name": "<string>",
          "status": "<string>",
          "source_name": "<string>",
          "source_status": "<string>",
          "remarks": "<string>",
          "source_remarks": "<string>",
          "source_page": 123
        }
      ]
    }
  ],
  "grade": {
    "code": "<string>",
    "source_label": "<string>",
    "source_meaning": "<string>"
  },
  "modification_assessments": {},
  "history_queries": [
    {
      "topic": "maintenance",
      "source_name": "<string>",
      "query_date": "<string>",
      "receipt_url": "<string>",
      "result": "unknown",
      "source_notice": "<string>"
    }
  ],
  "derived": {
    "basis": "api_rules",
    "exterior_repair_observed": true,
    "damage_severity": "unknown",
    "explanation": "Calculated from extracted observations; these are not the provider's own summary labels."
  },
  "is_rental": true,
  "usage_history": [
    "<string>"
  ],
  "had_accident": true,
  "had_simple_repair": true,
  "damage_severity": "unknown",
  "panel_damage": [
    {
      "panel": "<string>",
      "damage": [
        "<string>"
      ],
      "rank": "Exterior"
    }
  ],
  "uninspected_items": [
    "<string>"
  ],
  "has_tuning": true,
  "tuning_types": [
    "<string>"
  ],
  "first_registration_date": "<string>",
  "inspection_date": "<string>",
  "report_date": "<string>",
  "inspection_grade": "<string>",
  "inspection_report_print_url": "<string>",
  "was_flooded": true,
  "was_fire_damaged": true,
  "usage_type": "<string>",
  "note": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Behavior

The default view=summary returns conclusions, category totals, grades, dates, source links, and extraction coverage. view=full adds component-level items and separates API calculations under derived. An advertised report does not guarantee parsed data. This call consumes one data request. Authentication: Secret API key in X-API-Key. Quota: One successful call consumes one data request.

Request example

curl --fail-with-body "https://api.xapichina.com/v1/cars/59967821/inspection?view=summary&lang=en" \
  -H "X-API-Key: $XAPICHINA_API_KEY"

Illustrative response

The following example is abbreviated. It demonstrates the response shape rather than live inventory or guaranteed field coverage. The generated schema describes the complete contract.

{
  "available": true,
  "data_available": true,
  "parse_status": "partial",
  "report_provider": "Chaboshi",
  "report_type": "vehicle_condition",
  "conclusions": [],
  "categories": [
    {
      "name": "Exterior",
      "source_name": "外观",
      "reported_counts": {
        "正常": 12,
        "异常": 1
      },
      "parsed_item_count": 10,
      "count_matches": false
    }
  ],
  "grade": null,
  "history_queries": []
}

Read the integration guide for parameter rules, source interpretation, and error handling. Use the generated request playground with your own server-side API key.

Authorizations

X-API-Key

string

header

required

Path Parameters

car_id

integer

required

Query Parameters

lang

enum<string>

default:en

Response language: en (English) or zh (Chinese)

Available options:

en,

zh

view

enum<string>

default:summary

summary: provider conclusions and category counts; full: all checks, remarks and compatibility fields

Available options:

summary,

full

Response

Successful Response

InspectionReport
InspectionSummary

available

boolean

default:false

An inspection or vehicle-condition report is advertised; does not guarantee public access or a clean vehicle

inspection_report_url

string | null

HTTP(S) report link extracted from the listing, including wrapped app links; may expire or require provider access

report_type

enum<string> | null

Available options:

inspection,

vehicle_condition

data_available

boolean

default:false

Supported findings were extracted from the report, independently of whether a report is advertised

parse_status

enum<string>

default:not_available

Available options:

not_available,

parsed,

partial,

unsupported,

unavailable

report_provider

string | null

conclusions

ProviderConclusion · object[]

Provider-specific classifications, preserving original Chinese labels and source fields

Show child attributes

categories

ProviderInspectionCategory · object[]

Provider's own categories and all extracted component statuses, including normal, unknown, absent, and uninspectable items

Show child attributes

grade

ProviderGrade · object | null

Show child attributes

modification_assessments

Modification Assessments · object

Provider's assessment-specific modification flags; not a general tuning-history declaration

Show child attributes

history_queries

ProviderHistoryQuery · object[]

Lookup metadata supplied by the report. No records returned by a query does not establish absence of previous claims or maintenance

Show child attributes

derived

DerivedInspectionSummary · object | null

Clearly separated API calculations; source conclusions and categories remain authoritative

Show child attributes

is_rental

boolean | null

usage_history

string[] | null

had_accident

boolean | null

Provider's physical-inspection accident classification; not insurance claims or proof of no previous collisions

had_simple_repair

boolean | null

deprecated

Compatibility alias for API-derived exterior-repair observations; use categories and derived

damage_severity

enum<string>

default:unknown

deprecated

Compatibility alias for the API-derived severity; not a provider rating

Available options:

unknown,

none,

minor,

moderate,

severe

panel_damage

PanelDamage · object[] | null

deprecated

Compatibility subset of recognized abnormal component terms; categories preserve complete native statuses and remarks

Show child attributes

uninspected_items

string[] | null

has_tuning

boolean | null

tuning_types

string[] | null

first_registration_date

string | null

inspection_date

string | null

report_date

string | null

Report issue date, kept separate from the actual inspection date

inspection_grade

string | null

Original provider grade; grade systems differ between providers

inspection_report_print_url

string | null

was_flooded

boolean | null

Physical inspection's flood classification, not insurer history

was_fire_damaged

boolean | null

usage_type

string | null

note

string | null

⌘I

Get inspection findings and report links

curl --request GET \
  --url https://api.xapichina.com/v1/cars/{car_id}/inspection \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.xapichina.com/v1/cars/{car_id}/inspection', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "available": false,
  "inspection_report_url": "<string>",
  "report_type": "inspection",
  "data_available": false,
  "parse_status": "not_available",
  "report_provider": "<string>",
  "conclusions": [
    {
      "topic": "<string>",
      "label": "<string>",
      "source_label": "<string>",
      "source_fields": {}
    }
  ],
  "categories": [
    {
      "name": "<string>",
      "source_name": "<string>",
      "source_summary": "<string>",
      "reported_counts": {},
      "parsed_item_count": 0,
      "count_matches": true,
      "items": [
        {
          "name": "<string>",
          "status": "<string>",
          "source_name": "<string>",
          "source_status": "<string>",
          "remarks": "<string>",
          "source_remarks": "<string>",
          "source_page": 123
        }
      ]
    }
  ],
  "grade": {
    "code": "<string>",
    "source_label": "<string>",
    "source_meaning": "<string>"
  },
  "modification_assessments": {},
  "history_queries": [
    {
      "topic": "maintenance",
      "source_name": "<string>",
      "query_date": "<string>",
      "receipt_url": "<string>",
      "result": "unknown",
      "source_notice": "<string>"
    }
  ],
  "derived": {
    "basis": "api_rules",
    "exterior_repair_observed": true,
    "damage_severity": "unknown",
    "explanation": "Calculated from extracted observations; these are not the provider's own summary labels."
  },
  "is_rental": true,
  "usage_history": [
    "<string>"
  ],
  "had_accident": true,
  "had_simple_repair": true,
  "damage_severity": "unknown",
  "panel_damage": [
    {
      "panel": "<string>",
      "damage": [
        "<string>"
      ],
      "rank": "Exterior"
    }
  ],
  "uninspected_items": [
    "<string>"
  ],
  "has_tuning": true,
  "tuning_types": [
    "<string>"
  ],
  "first_registration_date": "<string>",
  "inspection_date": "<string>",
  "report_date": "<string>",
  "inspection_grade": "<string>",
  "inspection_report_print_url": "<string>",
  "was_flooded": true,
  "was_fire_damaged": true,
  "usage_type": "<string>",
  "note": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Search

Catalog

Vehicles

Reports

Account

Get inspection findings

Behavior

Request example

Illustrative response

Authorizations

Path Parameters

Query Parameters

Response

​Behavior

​Request example

​Illustrative response

Authorizations

Path Parameters

Query Parameters

Response

Behavior

Request example

Illustrative response