Skip to main content

Welcome to Steer AI API

The Steer AI API provides programmatic access to our AI-powered vehicle inspection, pricing, and CRM platform. Build custom integrations, automate workflows, and create powerful automotive applications.

Base URL

All API endpoints are relative to the base URL: Production: https://api.steerai.autos/v1 Sandbox: https://api-sandbox.steerai.autos/v1

Authentication

All API requests require authentication using Bearer tokens:
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Security Note: Never expose your API keys in client-side code. Always use server-side implementations for production applications.

Request/Response Format

Request Headers

All requests should include these headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
User-Agent: YourApp/1.0

Response Format

All API responses follow this consistent structure:
{
  "status": "success",
  "data": {
    // Response data here
  },
  "meta": {
    "request_id": "req_1234567890abcdef",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.234,
    "rate_limit": {
      "limit": 1000,
      "remaining": 999,
      "reset": 1640995200
    }
  }
}

Core API Endpoints

Rate Limits

Rate limits are enforced per API key and vary by plan:
PlanRequests/HourConcurrentBurst Limit
Free1,000550
Starter10,00020200
Professional100,0001001,000
EnterpriseUnlimitedCustomCustom

SDKs and Libraries

Python SDK

pip install steer-ai
Full-featured Python library with async support

JavaScript SDK

npm install @steerai/sdk
TypeScript-ready SDK for Node.js and browsers

Example Requests

Vehicle Inspection

curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "make": "Honda",
      "model": "Civic",
      "year": 2021
    },
    "inspection_type": "full"
  }'

Pricing Valuation

curl -X POST "https://api.steerai.autos/v1/pricing/valuate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890",
    "mileage": 50000,
    "condition": "good"
  }'

CRM Lead Creation

curl -X POST "https://api.steerai.autos/v1/crm/leads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "source": "website"
  }'

Error Handling

All API responses follow a consistent error format:
{
  "status": "error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid VIN format",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890abcdef"
  }
}

Common Error Codes

CodeHTTP StatusDescription
INVALID_API_KEY401API key is invalid or expired
RATE_LIMIT_EXCEEDED429Too many requests
VALIDATION_ERROR400Request data is invalid
RESOURCE_NOT_FOUND404Requested resource doesn’t exist
INTERNAL_ERROR500Server error, retry the request

Webhooks

Configure webhooks to receive real-time updates:
curl -X POST "https://api.steerai.autos/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/steerai",
    "events": ["inspection.completed", "pricing.calculated"]
  }'

Support