Introduction

Welcome to the Cardog API documentation. Our API provides comprehensive access to vehicle data, market insights, and automotive services. Whether you're building a dealership platform, market analysis tool, or automotive application, Cardog API offers the data and functionality you need.

Getting Started

To start using the Cardog API:

Create an account at cardog.app
Create an API key in the API Keys section

Use the API key in your requests:

curl "https://api.cardog.io/v1/vin/12345678901234567" \
   -H "x-api-key: your-api-key"

API Principles

Our API is designed with these principles in mind:

RESTful Design: Consistent resource-oriented URLs, proper HTTP methods, and standard status codes
Comprehensive Data: Deep vehicle information from trusted sources
Real-time Updates: Current market data and pricing information

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Request

GET

/v1/vin/12345678901234567

curl "https://api.cardog.io/v1/vin/12345678901234567" \
   -H "x-api-key: your-api-key"

Error Handling

The API uses conventional HTTP response codes:

200: Success
400: Client errors (invalid requests)
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Server errors

Error responses include detailed information:

{
  "error": {
    "code": "invalid_vin",
    "message": "The provided VIN is invalid",
    "details": {
      "field": "vin",
      "reason": "checksum_mismatch"
    }
  }
}