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

# Lookup vehicle by license plate

> Retrieves vehicle information from Chilean vehicle registry via Boostr API. The license plate will be normalized (uppercase, 6 alphanumeric characters). Dashes and spaces are automatically removed.



## OpenAPI

````yaml /generated/specs/clients.json get /api/v1/vehicles/lookup/{plate}
openapi: 3.0.0
info:
  title: Raul API - Clientes
  description: Clientes, clientes padre, direcciones, contactos y activos asociados.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags:
  - name: Clients
    description: Gestion de clientes
paths:
  /api/v1/vehicles/lookup/{plate}:
    get:
      tags:
        - Vehicles
      summary: Lookup vehicle by license plate
      description: >-
        Retrieves vehicle information from Chilean vehicle registry via Boostr
        API. The license plate will be normalized (uppercase, 6 alphanumeric
        characters). Dashes and spaces are automatically removed.
      operationId: VehicleLookupController_lookupVehicle
      parameters:
        - name: plate
          required: true
          in: path
          description: Chilean license plate (e.g., "BBCL12", "BB-CL-12", "BB CL 12")
          schema:
            minLength: 1
            maxLength: 10
            example: BBCL12
            type: string
      responses:
        '200':
          description: Vehicle information retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleLookupResponseDto'
        '400':
          description: >-
            Invalid license plate format (must be 6 alphanumeric characters
            after normalization)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleLookupErrorResponseDto'
        '401':
          description: Unauthorized - Invalid or missing JWT token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleLookupErrorResponseDto'
        '404':
          description: Vehicle not found in registry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleLookupErrorResponseDto'
        '500':
          description: Internal server error or Boostr API error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleLookupErrorResponseDto'
        '504':
          description: Boostr API timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleLookupErrorResponseDto'
      security:
        - bearerAuth: []
components:
  schemas:
    VehicleLookupResponseDto:
      type: object
      properties:
        plate:
          type: string
          description: Normalized license plate (6 uppercase alphanumeric chars)
          example: BBCL12
        dv:
          type: object
          description: License plate verification digit
          example: K
          nullable: true
        brand:
          type: string
          description: Vehicle brand/manufacturer
          example: TOYOTA
        model:
          type: string
          description: Vehicle model
          example: HILUX
        version:
          type: object
          description: Detailed vehicle version
          example: 2.4 SR 4X4 DIESEL AUT
          nullable: true
        year:
          type: number
          description: Vehicle manufacturing year
          example: 2020
        vehicleType:
          type: number
          description: Numeric vehicle type code
          example: 4
        vehicleTypeName:
          type: string
          description: Human-readable vehicle type name
          example: CAMIONETA
        vin:
          type: object
          description: Vehicle Identification Number (VIN/Chassis)
          example: 8AJMS21L9MZ000123
          nullable: true
        color:
          type: object
          description: Vehicle color
          example: BLANCO
          nullable: true
        engineNumber:
          type: object
          description: Engine number
          example: 1GD0000000
          nullable: true
        engineSize:
          type: object
          description: Engine displacement size
          example: '2.4'
          nullable: true
        doors:
          type: object
          description: Number of doors
          example: 4
          nullable: true
        transmission:
          type: object
          description: Transmission type
          example: AUTOMATICA
          nullable: true
        kilometers:
          type: object
          description: Recorded kilometers
          example: 45000
          nullable: true
        valuation:
          type: object
          description: Estimated vehicle valuation in CLP
          example: 18500000
          nullable: true
        gasType:
          type: object
          description: Fuel/gas type
          example: DIESEL
          nullable: true
        manufacturer:
          type: object
          description: Vehicle manufacturer company
          example: Toyota Motor Corporation
          nullable: true
        region:
          type: object
          description: Manufacturing region
          example: Asia
          nullable: true
        country:
          type: object
          description: Country of origin
          example: Japan
          nullable: true
        lastQueryDate:
          type: object
          description: Last query date from data source
          example: '2024-01-15'
          nullable: true
      required:
        - plate
        - brand
        - model
        - year
        - vehicleType
        - vehicleTypeName
    VehicleLookupErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP status code
          example: 404
        message:
          type: string
          description: Error message
          example: Vehicle not found
        error:
          type: string
          description: Error type
          example: Not Found
      required:
        - statusCode
        - message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token authentication

````