Repair Angel API v2

{ "message": "Logged out" }

{
  "id": 1, "name": "John Doe", "email": "john@example.com",
  "role": "admin", "company_id": 5
}

{
  "id": 101, "ticket_no": "WO-2026-0101",
  "customer": { "id": 42, "name": "Jane Smith" },
  "device_brand": "Apple", "device_model": "iPhone 15 Pro",
  "status": { "slug": "in_repair", "label": "In Repair" },
  "lines": [], "notes": [], "created_at": "2026-03-27T10:00:00Z"
}

[
  { "product_id": 1, "sku": "SCR-IP15-BLK", "name": "iPhone 15 Screen", "quantity": 12, "min_stock": 3 },
  ...
]

[ { "product_id": 5, "sku": "CAB-USB-C", "quantity": 30, "bin": "A-01-02" }, ... ]

[ { "id": 1, "code": "1000", "name": "Kas", "type": "asset" }, ... ]

[ { "id": 1, "year": 2026, "quarter": 1, "status": "open", "total_vat": 4821.00 } ]

[ { "id": 1, "name": "Alice B.", "role": "Technician", "email": "alice@shop.nl" }, ... ]

{
  "id": 1,
  "license_type": "SMR",
  "tier": "growth",
  "status": "active",
  "valid_until": "2027-03-27",
  "max_users": 15,
  "price_monthly": "149.00",
  "modules": [
    { "module_key": "work_orders", "is_active": true },
    { "module_key": "invoices", "is_active": true },
    ...
  ]
}

[
  { "module_key": "work_orders", "available": true, "is_active": true, "activated_at": "2026-01-01T00:00:00Z" },
  { "module_key": "accounting", "available": true, "is_active": false, "activated_at": null },
  ...
]

{ "has_module": true }

{ "status": "In Transit", "activities": [ { "location": "Amsterdam", "description": "Departed facility", "date": "2026-03-27" } ] }

{ "is_valid": true, "name": "ACME BV", "vat_number": "NL123456789B01", "country_code": "NL" }

{
  "customers": [ { "id": 42, "name": "Jane Smith" } ],
  "work_orders": [ { "id": 101, "ticket_no": "WO-2026-0101" } ],
  "products": [],
  "invoices": []
}

{ "token": "5|xKqz9...", "name": "Zapier Integration" }

{
  "data": [
    {
      "id": 55,
      "type": "work_order",
      "title": "WO-2026-0055 status changed",
      "body": "Work order moved to In Repair",
      "read_at": null,
      "created_at": "2026-03-27T09:12:00Z"
    }
  ],
  "current_page": 1, "last_page": 3, "total": 112
}

{ "message": "All notifications marked as read", "count": 34 }

{ "count": 7 }

{
  "work_orders": [
    { "key": "wo_status_changed", "label": "Status changed", "channels": ["in_app", "email"] },
    { "key": "wo_assigned",       "label": "Engineer assigned", "channels": ["in_app"] }
  ],
  "invoices": [ { "key": "invoice_overdue", "label": "Invoice overdue", "channels": ["in_app", "email", "push"] } ],
  "tasks": [...],
  "sla": [...],
  "system": [...]
}

// Request body
{
  "preferences": {
    "wo_status_changed": ["in_app", "email"],
    "invoice_overdue":   ["in_app", "push"]
  }
}

{ "message": "Test notification sent via in_app" }

[
  { "id": 1, "title": "Getting Started", "role": "all", "total_steps": 5 },
  { "id": 2, "title": "Creating a Work Order", "role": "technician", "total_steps": 7 }
]

{
  "id": 1, "title": "Getting Started",
  "steps": [
    { "id": 1, "order": 1, "title": "Welcome", "body": "...", "completed": true },
    { "id": 2, "order": 2, "title": "Dashboard overview", "body": "...", "completed": false }
  ]
}

[
  {
    "tutorial": { "id": 1, "title": "Getting Started" },
    "total_steps": 5, "completed_steps": 3,
    "percent": 60, "completed": false
  }
]

{ "message": "Step marked complete", "percent": 40, "completed": false }

{ "message": "Tutorial progress reset" }

{
  "tutorials_enabled": true,
  "completed_onboarding": false,
  "dismissed_hints": ["dashboard_hint", "wo_hint"]
}

{ "message": "14 tutorials seeded" }

{
  "data": [
    {
      "id": 301,
      "event": "status_changed",
      "description": "Status changed from New to In Repair",
      "user": { "id": 3, "name": "Jan Bakker" },
      "created_at": "2026-03-27T08:45:00Z"
    }
  ],
  "current_page": 1, "last_page": 2, "total": 18
}

{
  "id": 302, "event": "note_added",
  "description": "Waiting for spare part from supplier.",
  "user": { "id": 3, "name": "Jan Bakker" },
  "created_at": "2026-03-27T09:00:00Z"
}

// Request body
{
  "customer_id": 42,
  "valid_until": "2026-04-30",
  "lines": [
    { "description": "Screen replacement", "qty": 1, "unit_price": 120.00, "vat_pct": 21 }
  ]
}

{ "message": "Quotation sent", "status": "sent" }

{ "invoice_id": 78, "message": "Invoice created from quotation" }

{ "work_order_id": 203, "message": "Work order created from quotation" }

[
  { "status": "open",        "tasks": [{ "id": 10, "title": "Order spare parts" }] },
  { "status": "in_progress", "tasks": [{ "id": 11, "title": "Call customer" }] },
  { "status": "done",        "tasks": [] }
]

{ "message": "Task reordered" }

[
  {
    "id": 1, "name": "Auto-close after 30 days",
    "trigger": "wo_idle", "active": true,
    "last_run_at": "2026-03-26T23:00:00Z"
  }
]

{ "active": false, "message": "Rule deactivated" }

{
  "data": [
    { "ran_at": "2026-03-26T23:00:00Z", "outcome": "success", "affected_records": 3 }
  ]
}

{
  "period": "30d",
  "data": [
    { "date": "2026-02-25", "amount": 1240.50 },
    { "date": "2026-02-26", "amount": 890.00 }
  ],
  "total": 38450.75,
  "growth_pct": 12.4
}

{
  "status_distribution": { "new": 12, "in_repair": 34, "completed": 198 },
  "avg_duration_hours": 18.4,
  "completion_rate_pct": 94.2
}

[
  { "engineer_id": 3, "name": "Jan Bakker", "completed": 45, "avg_hours": 16.2, "revenue": 9800.00 }
]

{
  "new_customers": 14, "returning_customers": 63,
  "avg_ltv": 420.50
}

{
  "top_parts": [
    { "product_id": 7, "name": "iPhone 14 Screen", "used": 28 }
  ],
  "inventory_value": 14250.00
}

{
  "outstanding_amount": 8420.00,
  "overdue_amount": 1240.00,
  "avg_payment_days": 11.3
}

{
  "id": 15, "status": "pending",
  "work_order_id": 101, "created_at": "2026-03-27T10:00:00Z"
}

{ "message": "Claim approved", "warranty_work_order_id": 250 }

{ "message": "Claim rejected", "status": "rejected" }

{
  "data": [
    { "work_order_id": 88, "sla_config": "Standard 24h", "breached_at": "2026-03-26T14:00:00Z", "overdue_hours": 6.5 }
  ]
}

{ "message": "SLA check completed", "new_breaches": 2 }

{
  "id": 9, "credit_note_number": "CN-2026-0009",
  "total": -48.40, "status": "open"
}

{ "message": "Credit applied", "invoice_remaining": 71.60 }

{ "invoice_id": 134, "message": "Invoice generated" }

[
  { "id": 1, "name": "Amsterdam HQ", "address": "Damrak 1, Amsterdam", "active": true },
  { "id": 2, "name": "Rotterdam",   "address": "Coolsingel 10, Rotterdam", "active": true }
]

{
  "connected": true,
  "calls_today": 38,
  "missed_today": 4,
  "avg_duration_sec": 187,
  "active_calls": 2
}

{
  "api_url": "https://pbx.example.com",
  "api_key": "••••••••",
  "extension_map": { "3": "100", "5": "101" }
}

{
  "data": [
    { "id": 4501, "caller": "+31612345678", "extension": "100", "duration_sec": 243, "outcome": "answered", "started_at": "2026-03-27T09:05:00Z" }
  ]
}

[
  { "caller": "+31687654321", "waiting_sec": 45, "position": 1 }
]

[
  { "user_id": 3, "name": "Jan Bakker", "extension": "100" }
]

{
  "today": 24,
  "this_month": 412,
  "delivery_rate": 98.3,
  "cost_this_month": 8.24
}

// Request body
{ "phone": "+31612345678", "body": "Your repair is ready for pickup!" }

// Response 200
{ "message_id": "sms_9x2k", "status": "queued" }

[
  { "id": 1, "name": "Ready for pickup", "body": "Your repair is ready. Please collect at your convenience." }
]

{ "queued": 84, "message": "84 SMS messages queued for delivery" }

{
  "host": "smtp.mailgun.org",
  "port": 587,
  "encryption": "tls",
  "username": "postmaster@mg.example.com",
  "from_name": "Repair Angel",
  "from_address": "noreply@example.com"
}

{
  "id": 77, "subject": "Re: Your repair status",
  "customer": { "id": 42, "name": "Jane Smith" },
  "messages": [
    { "id": 1, "direction": "outbound", "body_html": "<p>Your iPhone is ready...</p>", "sent_at": "2026-03-27T08:00:00Z" },
    { "id": 2, "direction": "inbound",  "body_html": "<p>Thanks, I'll pick it up at 5pm.</p>", "sent_at": "2026-03-27T10:30:00Z" }
  ]
}

// Request body
{
  "to": "customer@example.com",
  "subject": "Your repair is ready",
  "body_html": "<p>Good news! Your device is ready for pickup.</p>"
}

// Response 200
{ "thread_id": 78, "message_id": "msg_abc123", "status": "sent" }

[
  { "id": 1, "name": "Repair Ready", "subject": "Your repair is ready", "updated_at": "2026-01-15" }
]

// Request body
{
  "device_brand": "Apple",
  "device_model": "iPhone 14 Pro",
  "symptoms": "Screen cracked, touch unresponsive in bottom half",
  "customer_type": "individual"
}

// Response 200
{
  "suggestions": [
    {
      "name": "Screen replacement",
      "confidence": "high",
      "estimated_price": 149.00,
      "description": "Full OLED panel replacement including digitizer",
      "requires_diagnosis": false
    },
    {
      "name": "Digitizer calibration",
      "confidence": "medium",
      "estimated_price": 45.00,
      "description": "Software-level touch recalibration before hardware swap",
      "requires_diagnosis": true
    }
  ],
  "advice": "Recommend screen replacement as primary fix. Run diagnostics first to rule out logic board damage.",
  "not_repairable": false
}

{
  "enabled": true,
  "openai_model": "gpt-4o",
  "diagnosis_cost": 25.00,
  "diagnosis_tax_rate_id": 3,
  "max_suggestions": 5
}

[
  { "id": 1, "name": "Standard 21%", "rate": 21.00, "description": "Standard Dutch BTW", "is_default": true },
  { "id": 2, "name": "Low 9%",      "rate": 9.00,  "description": "Reduced rate",         "is_default": false },
  { "id": 3, "name": "Zero 0%",     "rate": 0.00,  "description": "Exempt",                "is_default": false }
]

// Response 201
{ "id": 4, "name": "Margin scheme", "rate": 9.00, "description": "Used-goods margin", "is_default": false }

// 422 — tax rate in use
{
  "message": "Cannot delete: tax rate is assigned to 12 product(s)."
}

// Response 200
{ "id": 1, "name": "Standard 21%", "is_default": true }

// Response 200
{
  "has_agreement": true,
  "agreement": { "id": 12, "agreed_price": 89.00, "valid_until": "2026-12-31" },
  "business_discount_pct": 10,
  "recommended_price": 89.00,
  "base_price": 110.00,
  "discount_amount": 21.00
}

// Response 201
{
  "id": 13, "status": "draft", "customer_id": 42, "service_id": 7,
  "agreed_price": 89.00, "valid_from": "2026-04-01", "valid_until": null
}

{ "id": 13, "status": "active", "activated_at": "2026-03-27T09:00:00Z" }

{ "id": 13, "status": "signed", "signed_at": "2026-03-27T10:15:00Z" }

{ "id": 13, "contract_url": "/api/pricing/agreements/13/contract", "generated_at": "2026-03-27T10:20:00Z" }

[
  {
    "slug": "mollie",
    "name": "Mollie Payments",
    "is_enabled": true,
    "config": { "api_key": "***masked***" }
  },
  {
    "slug": "openai",
    "name": "OpenAI",
    "is_enabled": true,
    "config": { "api_key": "***masked***", "organisation_id": "***masked***" }
  }
  // ... 11 more
]

// GET /api/integrations/stripe
{
  "slug": "stripe",
  "name": "Stripe",
  "is_enabled": false,
  "config": {
    "publishable_key": "pk_test_***masked***",
    "secret_key": "***masked***",
    "webhook_secret": "***masked***"
  }
}

// Request — enable Mollie and set API key
{
  "is_enabled": true,
  "config": { "api_key": "live_xxxxxxxxxxxxxxxx" }
}

// Response 200
{ "slug": "mollie", "is_enabled": true, "updated_at": "2026-03-27T11:00:00Z" }

// Response 200 — success
{
  "success": true,
  "message": "Connected to Mollie — account: RepairAngel BV",
  "tested_at": "2026-03-27T11:05:22Z"
}

// Response 200 — failure (still HTTP 200, check "success")
{
  "success": false,
  "message": "Authentication failed: invalid API key",
  "tested_at": "2026-03-27T11:05:22Z"
}

{
  "employee_id": 5,
  "provider": "3cx",
  "extension": "101",
  "mobile_number": "+31612345678",
  "forwarding_number": "+31201234567",
  "sip_username": "john.doe@pbx.example.com",
  "sip_password": "***masked***",
  "is_active": true
}

{
  "employee_id": 5,
  "provider": "smtp",
  "email_address": "john.doe@example.com",
  "display_name": "John Doe — Repair Angel",
  "smtp_host": "mail.example.com",
  "smtp_port": 587,
  "smtp_encryption": "tls",
  "smtp_username": "john.doe@example.com",
  "smtp_password": "***masked***",
  "is_default": true
}

// Response 200 — success
{ "success": true,  "message": "Test email delivered to john.doe@example.com" }

// Response 200 — failure
{ "success": false, "message": "SMTP connection refused on port 587" }