> ## 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 insurance-event evidence

> Retrieve insurance-event query metadata and claim-record availability.

## Behavior

Structured insurance claims are currently unavailable, so `available` remains `false`. Separate vehicle-report advertising and supported query dates, notices, and receipts can still be returned. Empty evidence or `no_records_returned` does not establish a clean history. This is a separate 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/insurance?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": false,
  "vehicle_report_advertised": true,
  "query_evidence": [],
  "owner_transfer_count": null,
  "usage_type": null,
  "note": "Structured insurance claim records are unavailable."
}
```

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}/insurance
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}/insurance:
    get:
      tags:
        - Cars
      summary: Get insurance-event query evidence and claim-record availability
      operationId: get_insurance_v1_cars__car_id__insurance_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)'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsuranceHistory'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    InsuranceHistory:
      properties:
        available:
          type: boolean
          title: Available
          description: >-
            Insurance claim history is exposed through this API; unavailable in
            Che168's public listing payload
          default: false
        vehicle_report_advertised:
          type: boolean
          title: Vehicle Report Advertised
          description: >-
            A separate inspection or vehicle-condition report is advertised;
            this is not insurance claim history
          default: false
        query_evidence:
          items:
            $ref: '#/components/schemas/ProviderHistoryQuery'
          type: array
          title: Query Evidence
          description: >-
            Insurance-event query dates, notices, and receipts from supported
            vehicle reports; not structured claim records
        owner_transfer_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Owner Transfer Count
        usage_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Usage Type
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
      type: object
      title: InsuranceHistory
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    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
  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.