> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xapichina.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get inspection findings

> Retrieve a compact report summary or full provider-native findings.

## 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

```bash theme={"system"}
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.

```json theme={"system"}
{
  "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](/inspection-and-insurance) for parameter rules, source interpretation, and error handling. Use the generated request playground with your own server-side API key.


## OpenAPI

````yaml openapi.json GET /v1/cars/{car_id}/inspection
openapi: 3.1.0
info:
  title: XAPI China
  description: >-
    Search Chinese used-car listings and retrieve vehicle details, photos,
    CNY/EUR prices, and supported provider-native inspection data.


    XAPI China is an independent service and is not affiliated with or endorsed
    by Che168.


    Authenticate data requests with X-API-Key. GET /v1/makes and GET /v1/filters
    are public. English responses are the default; use lang=zh for Chinese
    output.


    Inspection coverage is explicit. Insurance-event query evidence is not
    structured insurance claim history.


    Create keys and check your account-wide allowance in the XAPI China
    dashboard: https://xapichina.com/dashboard.
  version: 1.0.0
servers:
  - url: https://api.xapichina.com
    description: Production
security: []
paths:
  /v1/cars/{car_id}/inspection:
    get:
      tags:
        - Cars
      summary: Get inspection findings and report links
      description: >-
        Returns a compact summary of Chinese provider conclusions, native
        category counts, dates and report links by default. Use view=full for
        every extracted component status/remark, original source wording and
        API-derived compatibility fields. Advertised reports and parsed data
        have separate availability fields; missing information remains unknown.
      operationId: get_inspection_v1_cars__car_id__inspection_get
      parameters:
        - name: car_id
          in: path
          required: true
          schema:
            type: integer
            title: Car Id
        - name: lang
          in: query
          required: false
          schema:
            enum:
              - en
              - zh
            type: string
            description: 'Response language: en (English) or zh (Chinese)'
            default: en
            title: Lang
          description: 'Response language: en (English) or zh (Chinese)'
        - name: view
          in: query
          required: false
          schema:
            enum:
              - summary
              - full
            type: string
            description: >-
              summary: provider conclusions and category counts; full: all
              checks, remarks and compatibility fields
            default: summary
            title: View
          description: >-
            summary: provider conclusions and category counts; full: all checks,
            remarks and compatibility fields
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/InspectionReport'
                  - $ref: '#/components/schemas/InspectionSummary'
                title: Response Get Inspection V1 Cars  Car Id  Inspection Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    InspectionReport:
      properties:
        available:
          type: boolean
          title: Available
          description: >-
            An inspection or vehicle-condition report is advertised; does not
            guarantee public access or a clean vehicle
          default: false
        inspection_report_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Report Url
          description: >-
            HTTP(S) report link extracted from the listing, including wrapped
            app links; may expire or require provider access
        report_type:
          anyOf:
            - type: string
              enum:
                - inspection
                - vehicle_condition
            - type: 'null'
          title: Report Type
        data_available:
          type: boolean
          title: Data Available
          description: >-
            Supported findings were extracted from the report, independently of
            whether a report is advertised
          default: false
        parse_status:
          type: string
          enum:
            - not_available
            - parsed
            - partial
            - unsupported
            - unavailable
          title: Parse Status
          default: not_available
        report_provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Provider
        conclusions:
          items:
            $ref: '#/components/schemas/ProviderConclusion'
          type: array
          title: Conclusions
          description: >-
            Provider-specific classifications, preserving original Chinese
            labels and source fields
        categories:
          items:
            $ref: '#/components/schemas/ProviderInspectionCategory'
          type: array
          title: Categories
          description: >-
            Provider's own categories and all extracted component statuses,
            including normal, unknown, absent, and uninspectable items
        grade:
          anyOf:
            - $ref: '#/components/schemas/ProviderGrade'
            - type: 'null'
        modification_assessments:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Modification Assessments
          description: >-
            Provider's assessment-specific modification flags; not a general
            tuning-history declaration
        history_queries:
          items:
            $ref: '#/components/schemas/ProviderHistoryQuery'
          type: array
          title: History Queries
          description: >-
            Lookup metadata supplied by the report. No records returned by a
            query does not establish absence of previous claims or maintenance
        derived:
          anyOf:
            - $ref: '#/components/schemas/DerivedInspectionSummary'
            - type: 'null'
          description: >-
            Clearly separated API calculations; source conclusions and
            categories remain authoritative
        is_rental:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Rental
        usage_history:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Usage History
        had_accident:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Had Accident
          description: >-
            Provider's physical-inspection accident classification; not
            insurance claims or proof of no previous collisions
        had_simple_repair:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Had Simple Repair
          description: >-
            Compatibility alias for API-derived exterior-repair observations;
            use categories and derived
          deprecated: true
        damage_severity:
          type: string
          enum:
            - unknown
            - none
            - minor
            - moderate
            - severe
          title: Damage Severity
          description: >-
            Compatibility alias for the API-derived severity; not a provider
            rating
          default: unknown
          deprecated: true
        panel_damage:
          anyOf:
            - items:
                $ref: '#/components/schemas/PanelDamage'
              type: array
            - type: 'null'
          title: Panel Damage
          description: >-
            Compatibility subset of recognized abnormal component terms;
            categories preserve complete native statuses and remarks
          deprecated: true
        uninspected_items:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Uninspected Items
        has_tuning:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Tuning
        tuning_types:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Tuning Types
        first_registration_date:
          anyOf:
            - type: string
            - type: 'null'
          title: First Registration Date
        inspection_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Date
        report_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Date
          description: Report issue date, kept separate from the actual inspection date
        inspection_grade:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Grade
          description: Original provider grade; grade systems differ between providers
        inspection_report_print_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Report Print Url
        was_flooded:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Was Flooded
          description: Physical inspection's flood classification, not insurer history
        was_fire_damaged:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Was Fire Damaged
        usage_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Usage Type
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
      type: object
      title: InspectionReport
    InspectionSummary:
      properties:
        available:
          type: boolean
          title: Available
          default: false
        data_available:
          type: boolean
          title: Data Available
          default: false
        parse_status:
          type: string
          enum:
            - not_available
            - parsed
            - partial
            - unsupported
            - unavailable
          title: Parse Status
          default: not_available
        report_provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Provider
        report_type:
          anyOf:
            - type: string
              enum:
                - inspection
                - vehicle_condition
            - type: 'null'
          title: Report Type
        conclusions:
          items:
            $ref: '#/components/schemas/ProviderConclusion'
          type: array
          title: Conclusions
        categories:
          items:
            $ref: '#/components/schemas/ProviderInspectionCategorySummary'
          type: array
          title: Categories
          description: >-
            Provider category totals and extraction coverage; individual checks
            are available with view=full
        grade:
          anyOf:
            - $ref: '#/components/schemas/ProviderGrade'
            - type: 'null'
        modification_assessments:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Modification Assessments
        history_queries:
          items:
            $ref: '#/components/schemas/ProviderHistoryQuery'
          type: array
          title: History Queries
        first_registration_date:
          anyOf:
            - type: string
            - type: 'null'
          title: First Registration Date
        inspection_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Date
        report_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Date
        usage_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Usage Type
        inspection_report_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Report Url
        inspection_report_print_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Inspection Report Print Url
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
      type: object
      title: InspectionSummary
      description: >-
        Compact provider conclusions and coverage; individual checks require
        view=full.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ProviderConclusion:
      properties:
        topic:
          type: string
          title: Topic
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
        source_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Label
        source_fields:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Source Fields
      type: object
      required:
        - topic
      title: ProviderConclusion
    ProviderInspectionCategory:
      properties:
        name:
          type: string
          title: Name
        source_name:
          type: string
          title: Source Name
        source_summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Summary
        reported_counts:
          additionalProperties:
            type: integer
          type: object
          title: Reported Counts
        parsed_item_count:
          type: integer
          title: Parsed Item Count
          default: 0
        count_matches:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Count Matches
          description: >-
            Whether parsed item count matches the provider's declared total;
            does not establish that all items were inspectable
        items:
          items:
            $ref: '#/components/schemas/ProviderInspectionItem'
          type: array
          title: Items
      type: object
      required:
        - name
        - source_name
      title: ProviderInspectionCategory
    ProviderGrade:
      properties:
        code:
          type: string
          title: Code
        source_label:
          type: string
          title: Source Label
        source_meaning:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Meaning
      type: object
      required:
        - code
        - source_label
      title: ProviderGrade
    ProviderHistoryQuery:
      properties:
        topic:
          type: string
          enum:
            - maintenance
            - insurance_events
          title: Topic
        source_name:
          type: string
          title: Source Name
        query_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Query Date
        receipt_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Receipt Url
        result:
          type: string
          enum:
            - no_records_returned
            - unknown
          title: Result
          default: unknown
        source_notice:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Notice
      type: object
      required:
        - topic
        - source_name
      title: ProviderHistoryQuery
    DerivedInspectionSummary:
      properties:
        basis:
          type: string
          const: api_rules
          title: Basis
          default: api_rules
        exterior_repair_observed:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Exterior Repair Observed
        damage_severity:
          type: string
          enum:
            - unknown
            - none
            - minor
            - moderate
            - severe
          title: Damage Severity
          default: unknown
        explanation:
          type: string
          title: Explanation
          default: >-
            Calculated from extracted observations; these are not the provider's
            own summary labels.
      type: object
      title: DerivedInspectionSummary
    PanelDamage:
      properties:
        panel:
          type: string
          title: Panel
        damage:
          items:
            type: string
          type: array
          title: Damage
        rank:
          anyOf:
            - type: string
              enum:
                - Exterior
                - Structural (Frame)
            - type: 'null'
          title: Rank
          description: API-derived grouping, not the provider's own component category
      type: object
      required:
        - panel
        - damage
      title: PanelDamage
    ProviderInspectionCategorySummary:
      properties:
        name:
          type: string
          title: Name
        source_name:
          type: string
          title: Source Name
        source_summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Summary
        reported_counts:
          additionalProperties:
            type: integer
          type: object
          title: Reported Counts
        parsed_item_count:
          type: integer
          title: Parsed Item Count
          default: 0
        count_matches:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Count Matches
          description: >-
            Whether parsed item count matches the provider's declared total;
            does not establish that all items were inspectable
      type: object
      required:
        - name
        - source_name
      title: ProviderInspectionCategorySummary
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ProviderInspectionItem:
      properties:
        name:
          type: string
          title: Name
        status:
          type: string
          title: Status
        remarks:
          anyOf:
            - type: string
            - type: 'null'
          title: Remarks
        source_name:
          type: string
          title: Source Name
        source_status:
          type: string
          title: Source Status
        source_remarks:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Remarks
        source_page:
          anyOf:
            - type: integer
            - type: 'null'
          title: Source Page
      type: object
      required:
        - name
        - status
        - source_name
        - source_status
      title: ProviderInspectionItem
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.