Skip to main content
This is a test version of the page. To contact the owner, email [email protected]
CarsKeep
🌐 en
🔌 REST API V1 & WEBHOOKS FOR DEVELOPERS

CarsKeep Open REST API v1 Platform

Connect your ERP, custom applications, telemetry hardware and accounting software to CarsKeep with Bearer JWT tokens and Zero Lock-in guarantee.

View API Documentation

API Architecture & Authentication

High-performance API Gateway with strict JWT/Bearer access token validation

API Base URL Production HTTPS Gateway
https://api.carskeep.com/api/v1/

All API requests are transmitted securely over HTTPS. Service tokens are generated in the shop owner admin portal with granular Bitset Capabilities. 

curl -X POST "https://api.carskeep.com/api/v1//orders" \
  -H "Authorization: Bearer ck_live_9f8a2e1d4c..." \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "JTDKN36U901234567",
      "plate": "10-AB-420",
      "model": "Toyota Camry 2.5 AT"
    },
    "bayNumber": 2,
    "mileageKm": 68420,
    "customer": {
      "name": "Alexei Ivanov",
      "phone": "+77014205566"
    },
    "services": [
      { "code": "SRV-OIL-01", "name": "Замена масла и фильтра", "hours": 0.8 },
      { "code": "SRV-BRK-02", "name": "Замена передних колодок", "hours": 1.2 }
    ]
  }'
HTTPS 201 Created
auth: bearer_tokengzip: 240b

Core REST API v1 Endpoints

Standardized CRUD endpoints designed to automate every workshop touchpoint

1. Online Booking & Lead Intake

3 routes
POST /api/v1/bookings/slots
Query available service bay time slots and technicians
POST /api/v1/bookings/create
Submit appointment reservation from websites or map apps
POST /api/v1/leads
Ingest promo landing leads with honeypot bot filtering

2. Repair Order Management

3 routes
GET /api/v1/repair-orders
List repair orders with status, bay, and date filtering
GET /api/v1/repair-orders/:id
Retrieve order items, labor lines, and DVI photos
POST /api/v1/repair-orders/:id/status
Transition repair order across workshop Kanban stages

3. FIFO Parts Inventory

3 routes
GET /api/v1/inventory/items
Search inventory items by OEM part number and VIN
POST /api/v1/inventory/batch-receive
Receive vendor invoices with FIFO purchase batch tracking
POST /api/v1/inventory/reserve
Allocate warehouse parts to an active repair order

4. Data Freedom & Zero Lock-in Export

1 routes
GET /api/v1/tenants/export/full
One-click cryptographic JSON dump of customer, vehicle, and inventory records

Events & Real-Time Webhooks

Instant webhook notifications for external systems, chat notifications, and BI tools

Sample Webhook JSON Payload:

event: ro.status_changed 
{
  "event": "repair_order.estimate_approved",
  "timestamp": "2026-09-30T10:14:22Z",
  "tenant_id": "ten_baku_4021",
  "data": {
    "repair_order_id": "ro_94021",
    "customer": {
      "name": "Рамиль Мамедов",
      "phone": "+994502000000"
    },
    "vehicle": {
      "vin": "KMHD381UBJU194021",
      "license_plate": "10-AB-402",
      "model": "Kia Sportage 2021"
    },
    "approved_amount": 155.00,
    "currency": "AZN",
    "approved_items": [
      { "type": "part", "code": "54813-2S000", "title": "Втулка стабилизатора", "qty": 2, "price": 20.00 },
      { "type": "labor", "code": "L-SU-04", "title": "Замена втулок стабилизатора", "hours": 0.8, "price": 35.00 }
    ]
  }
}
booking.created

New booking created via online widget or maps

Customer Booking
vehicle.checked_in

DVI intake inspection completed at service bay

Service Advisor Check-in
repair_order.estimate_approved

Customer approved repair estimate via WhatsApp link

Customer WhatsApp Approval
repair_order.completed

Quality control passed; vehicle ready for pickup

Work Completion
payment.fiscalized

Payment recorded and fiscal receipt generated

Cashdesk Payment

Telematics & OBD-II Scanner Integration

Direct telemetry ingestion from connected fleet tracking devices

Automatic Odometer Sync

Vehicle odometer records update daily via satellite GPS telemetry without manual mechanic entry.

DTC Trouble Code Alerts

When a Check Engine fault code (e.g., P0300 cylinder misfire) triggers, an automatic inspection task is dispatched to the service advisor.

Supported Hardware: Teltonika, Galileosky, StarLine, Ruptela, Navtelecom

Official Client SDKs

Type-safe SDKs with built-in schema validation and error handling

v1.4.0 • Zero DB Import

Node.js / TypeScript

npm install @carskeep/api-sdk
v1.2.0 • Asyncio ready

Python

pip install carskeep-sdk
REST OpenAPI 3.0

cURL / HTTP

curl -H "Authorization: Bearer token" https://api.carskeep.com
Catalog of 45+ Pre-built Integrations