Skip to content
AARAB v4.0 Intelligence Era

Interactive
API Console

Explore and test the AUTOVALUATIONPRO API endpoints in real-time. Authenticate with your enterprise key, trigger instant valuations, inspections, fraud checks, forecasts, and bulk fleet processing.

Available Endpoints

POST /api/valuation/instant

Trigger an immediate valuation task using core pricing engines.

HEADERS

Authorization: Bearer YOUR_ENTERPRISE_API_KEY
Content-Type: application/json

BODY (JSON)

{
  "user_id": 1,
  "vehicle_id": 101,
  "request_type": "instant",
  "client_type": "individual"
}

EXAMPLE RESPONSE

Status: 201 Created
{
  "message": "Valuation task created successfully.",
  "task_id": 480921,
  "status": "assigned",
  "link": "/api/valuation/status?id=480921"
}

POST /api/valuation/async

Queue complex tasks (Inspection, Fleet, Fraud Check) for background processing.

BODY (JSON)

{
  "user_id": 5,
  "vehicle_id": 204,
  "request_type": "inspection",
  "client_type": "insurance"
}

EXAMPLE RESPONSE

Status: 201 Created
{
  "message": "Valuation task created successfully.",
  "task_id": 480922,
  "status": "assigned",
  "link": "/api/valuation/status?id=480922"
}

GET /api/valuation/status

Check the real-time status of a valuation task.

QUERY PARAMETERS

id: 480921

EXAMPLE RESPONSE

Status: 200 OK
{
  "task_id": "480921",
  "status": "processing",
  "timestamp": "2025-12-29T14:25:00+00:00"
}

GET /api/valuation/results

Retrieve the final immutable valuation report and intelligence data.

QUERY PARAMETERS

id: 480921

EXAMPLE RESPONSE

Status: 200 OK
{
  "result_id": 8821,
  "task_id": 480921,
  "vehicle_id": 101,
  "user_id": 1,
  "valuation_amount": 5200000.00,
  "confidence_score": 0.9630,
  "forecast_12m": 4850000.00,
  "carbon_adjustment": -120000.00,
  "fraud_risk_score": 0.0000,
  "personas_contributed": ["Valuator-2.5o", "Inspector-AI", "Market-Solara"],
  "report_url": "https://autovaluationpro.arybit.co.ke/reports/480921_x8s9d.pdf",
  "created_at": "2025-12-29 14:30:00"
}

GET /api/valuation/tasks

List recent valuation tasks for a specific user.

QUERY PARAMETERS

user_id: 1

EXAMPLE RESPONSE

Status: 200 OK
[
  {
    "task_id": 480921,
    "status": "completed",
    "request_type": "instant",
    "created_at": "2025-12-29 14:22:10",
    "Make": "Toyota",
    "Model": "Prado",
    "Year": 2022,
    "VIN": "JTEBU58..."
  }
]