API Documentation

Check Car Availability

Endpoint: https://autobidcar.com/api/check/{vinOrLot}

Method: GET

Rate Limit: 100 requests per minute

Description

Checks if a car exists in our database and returns its URL if found. You can search using either a VIN number or lot number.

Parameters

vinOrLot (path parameter, required): Either a VIN number or lot number of the car

Response

Success (200 OK)

{
  "full_url": "https://autobidcar.com/car/2024-toyota-camry-1hgcm82633a123456"
}

Error Responses

  • 400 Bad Request
    {
      "detail": "Invalid identifier"
    }
  • 404 Not Found
    {
      "detail": "Car not found in our database."
    }

Example Usage

Using VIN:

GET /api/check/1HGCM82633A123456

Using Lot Number:

GET /api/check/12345

Notes

  • VIN numbers must follow standard VIN format
  • Lot numbers must be numeric and within valid length
  • The response includes the full URL to the car's detail page
  • Rate limiting is enforced at 100 requests per minute