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

> Retrieve normalized specifications, prices, photos, source links, and native Che168 fields.

## Behavior

Use a numeric listing ID returned by search. The response represents `id` as a string. Missing source fields can be `null`; missing native keys are omitted. Details already include `photos`, so a separate gallery call may be unnecessary. 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?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"}
{
  "id": "59967821",
  "title": "BMW 3 Series 2022 325Li",
  "manufacturer": "BMW",
  "model": "3 Series",
  "model_year": 2022,
  "mileage_km": 32000,
  "price_cny": 188000,
  "price_eur": 24102.56,
  "photos": [
    "https://example.com/listing-photo.jpg"
  ],
  "che168": {
    "catalog": {
      "brandname": "宝马",
      "seriesname": "宝马3系"
    },
    "electric_vehicle": null
  },
  "source_url": "https://www.che168.com/dealer/0/59967821.html"
}
```

Read the [integration guide](/vehicle-details) 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}
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}:
    get:
      tags:
        - Cars
      summary: Get car details
      operationId: get_car_v1_cars__car_id__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/CarDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    CarDetail:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
        manufacturer:
          anyOf:
            - type: string
            - type: 'null'
          title: Manufacturer
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
        model_year:
          anyOf:
            - type: integer
            - type: 'null'
          title: Model Year
        registration_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Registration Date
        mileage_km:
          anyOf:
            - type: integer
            - type: 'null'
          title: Mileage Km
        price_cny:
          anyOf:
            - type: integer
            - type: 'null'
          title: Price Cny
        price_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Price Eur
          description: >-
            CNY price converted to EUR, rounded to cents; null if price or
            exchange rate is unavailable
        original_price_cny:
          anyOf:
            - type: integer
            - type: 'null'
          title: Original Price Cny
        location:
          anyOf:
            - type: string
            - type: 'null'
          title: Location
        district:
          anyOf:
            - type: string
            - type: 'null'
          title: District
        color:
          anyOf:
            - type: string
            - type: 'null'
          title: Color
        fuel_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Fuel Type
        transmission:
          anyOf:
            - type: string
            - type: 'null'
          title: Transmission
        engine:
          anyOf:
            - type: string
            - type: 'null'
          title: Engine
        displacement_liters:
          anyOf:
            - type: number
            - type: 'null'
          title: Displacement Liters
        drive_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Drive Type
        body_style:
          anyOf:
            - type: string
            - type: 'null'
          title: Body Style
        emissions_standard:
          anyOf:
            - type: string
            - type: 'null'
          title: Emissions Standard
        seat_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Seat Count
        transfer_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Transfer Count
        usage_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Usage Type
        annual_inspection_until:
          anyOf:
            - type: string
            - type: 'null'
          title: Annual Inspection Until
        compulsory_insurance_until:
          anyOf:
            - type: string
            - type: 'null'
          title: Compulsory Insurance Until
        fuel_consumption_l_100km:
          anyOf:
            - type: number
            - type: 'null'
          title: Fuel Consumption L 100Km
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        thumbnail:
          anyOf:
            - type: string
            - type: 'null'
          title: Thumbnail
        photos:
          items:
            type: string
          type: array
          title: Photos
        tags:
          items:
            type: string
          type: array
          title: Tags
        published:
          anyOf:
            - type: string
            - type: 'null'
          title: Published
        follow_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Follow Count
        inspection_available:
          type: boolean
          title: Inspection Available
          description: >-
            An inspection or vehicle-condition report is advertised; use
            /inspection for supported findings and parsing status
          default: false
        insurance_available:
          type: boolean
          title: Insurance Available
          description: >-
            Insurance claim-history data is available through this API;
            currently false because the public provider payload does not expose
            it
          default: false
        che168:
          anyOf:
            - $ref: '#/components/schemas/Che168ListingData'
            - type: 'null'
          description: >-
            Provider-native vehicle fields. Original names, values, units, and
            Chinese text are preserved in both languages; missing keys are
            omitted
        source_url:
          type: string
          title: Source Url
      type: object
      required:
        - id
        - title
        - source_url
      title: CarDetail
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Che168ListingData:
      properties:
        catalog:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Catalog
        specification:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Specification
        vehicle_identity:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Vehicle Identity
        location:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Location
        registration:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Registration
        electric_vehicle:
          anyOf:
            - additionalProperties:
                anyOf:
                  - type: string
                  - type: integer
                  - type: number
                  - type: boolean
                  - type: 'null'
              type: object
            - type: 'null'
          title: Electric Vehicle
        warranty:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Warranty
        finance:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Finance
        consumption:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Consumption
        seller:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Seller
        media:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Media
        report_services:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Report Services
        listing:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
              - type: number
              - type: boolean
              - type: 'null'
          type: object
          title: Listing
      type: object
      title: Che168ListingData
      description: Vehicle data in Che168's own field names, units, and source language.
    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.