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

# Validate Vehicle History Finder input



## OpenAPI

````yaml /tools-reference/openapi.json post /tools/vehicle-history-finder/search
openapi: 3.1.0
info:
  title: Osintly Tools API
  version: 1.0.0
  description: >-
    OpenAPI specification for Osintly Epic Games and Vehicle History Finder
    tools and catalog endpoints.
  contact:
    name: Osintly
    url: https://docs.osint.ly/tools-reference/introduction
servers:
  - url: https://api.osint.ly
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Tools Catalog
    description: Discover available tools, metadata, and route costs.
  - name: Epic Games
    description: Direct Epic Games account validation and enrichment endpoints.
  - name: Vehicle History Finder
    description: >-
      Vehicle history enrichment endpoints for US VINs and French license
      plates.
paths:
  /tools/vehicle-history-finder/search:
    post:
      tags:
        - Vehicle History Finder
      summary: Validate Vehicle History Finder input
      operationId: runVehicleHistoryFinderSearch
      requestBody:
        $ref: '#/components/requestBodies/VehicleHistoryFinderRequest'
      responses:
        '200':
          $ref: '#/components/responses/VehicleHistoryFinderResponse'
        '400':
          $ref: '#/components/responses/ValidationError'
components:
  requestBodies:
    VehicleHistoryFinderRequest:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/VehicleHistoryFinderRequest'
          examples:
            plateFr:
              summary: French license plate
              value:
                value: AB-123-CD
                type: plate_fr
            vin:
              summary: US VIN
              value:
                value: 1HGCM82633A004352
                type: vin
  responses:
    VehicleHistoryFinderResponse:
      description: Vehicle history finder response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/VehicleHistoryFinderResponse'
          example:
            tool: vehicle-history-finder
            operation: vin
            query:
              value: 1HGCM82633A004352
              type: vin
            data:
              vehicle:
                found: true
                presentation:
                  title: Honda Accord 2003
                  make: Honda
                  model: Accord
                  year: 2003
                  bodyClass: Sedan
                  engine: 2.4L L4
              castrol:
                metadata: null
              nhtsa:
                recalls: []
                complaints: []
                safetyRatings: []
            meta:
              timestamp: '2026-06-28T12:00:00.000Z'
    ValidationError:
      description: Invalid request body or parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: VALIDATION_ERROR
              message: Invalid request body
              details:
                - path: value
                  message: Invalid value
            meta:
              timestamp: '2026-06-28T12:00:00.000Z'
  schemas:
    VehicleHistoryFinderRequest:
      type: object
      required:
        - value
        - type
      properties:
        value:
          type: string
          description: VIN or French license plate to validate or enrich.
          examples:
            - AB-123-CD
            - 1HGCM82633A004352
        type:
          type: string
          description: Canonical type or accepted alias.
          enum:
            - vin
            - plate_fr
            - plate
            - plaque
            - plaque_fr
            - license_plate_fr
            - french_plate
            - immatriculation
          example: plate_fr
        save:
          type: boolean
          description: >-
            Only used on `/all`. When true, saves the synchronous result for
            later retrieval.
          default: false
      additionalProperties: false
    VehicleHistoryFinderResponse:
      type: object
      required:
        - data
        - meta
        - operation
        - query
        - tool
      properties:
        data:
          type: object
          required:
            - vehicle
          properties:
            vehicle:
              type: object
              required:
                - found
                - presentation
              properties:
                found:
                  type: boolean
                presentation:
                  type: object
                  additionalProperties: true
              additionalProperties: true
            castrol:
              type: object
              additionalProperties: true
            nhtsa:
              type: object
              required:
                - recalls
                - complaints
                - safetyRatings
              properties:
                recalls:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
                complaints:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
                safetyRatings:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
              additionalProperties: true
          additionalProperties: true
        meta:
          $ref: '#/components/schemas/ResponseMeta'
        operation:
          type: string
        query:
          type: object
          required:
            - value
            - type
          properties:
            value:
              type: string
            type:
              type: string
            save:
              type: boolean
          additionalProperties: true
        tool:
          type: string
          enum:
            - vehicle-history-finder
      additionalProperties: false
    ErrorResponse:
      type: object
      required:
        - error
        - meta
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
            details: {}
          additionalProperties: true
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      additionalProperties: false
    ResponseMeta:
      type: object
      required:
        - timestamp
      properties:
        timestamp:
          type: string
          format: date-time
        savedResult:
          $ref: '#/components/schemas/SavedToolResult'
      additionalProperties: true
    SavedToolResult:
      type: object
      required:
        - id
        - url
      properties:
        id:
          type: string
          format: uuid
        url:
          type: string
          format: uri
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````