B
BayOS
Sign InStart Free Trial

Build on BayOS

RESTful API, webhooks, and scoped API keys. Integrate BayOS into your existing systems or build something entirely new.

Quick Start

# Authenticate with your API key

curl https://api.bayos.io/v1/repair-orders \

-H "Authorization: Bearer bay_sk_your_api_key" \

-H "Content-Type: application/json"

# Response

{
  "data": [
    {
      "id": "ro_abc123",
      "ro_number": 1047,
      "status": "IN_PROGRESS",
      "customer": { "name": "James Mitchell" },
      "vehicle": { "year": 2021, "make": "BMW", "model": "X5" },
      "total": 2340.00
    }
  ],
  "meta": { "page": 1, "total": 342 }
}

REST API Endpoints

Base URL: https://api.bayos.io/v1

GET/api/v1/repair-orders
POST/api/v1/repair-orders
GET/api/v1/repair-orders/:id
PATCH/api/v1/repair-orders/:id
GET/api/v1/customers
POST/api/v1/customers
GET/api/v1/vehicles
POST/api/v1/vehicles
GET/api/v1/invoices
GET/api/v1/appointments
POST/api/v1/appointments
GET/api/v1/inventory
POST/api/v1/messages
GET/api/v1/reports/revenue
GET/api/v1/time-entries

Webhooks

Subscribe to real-time events. BayOS sends a POST request to your endpoint with a signed payload whenever an event occurs.

repair_order.created
repair_order.status_changed
repair_order.closed
estimate.sent
estimate.approved
estimate.declined
invoice.created
invoice.paid
payment.received
appointment.created
appointment.cancelled
customer.created
inspection.completed
inspection.sent

# Example webhook payload

{
  "event": "repair_order.status_changed",
  "timestamp": "2026-02-17T14:30:00Z",
  "data": {
    "id": "ro_abc123",
    "ro_number": 1047,
    "previous_status": "WAITING_APPROVAL",
    "new_status": "APPROVED",
    "shop_id": "shop_xyz"
  }
}

Authentication

Bearer token auth with scoped API keys. Generate keys in Settings with fine-grained permissions per resource.

Rate Limits

1,000 requests per minute on Professional. 10,000 on Enterprise. Custom limits available. Rate limit headers included in every response.

SDKs

Official SDKs for Node.js, Python, and PHP. Community libraries for Go and Ruby. OpenAPI spec available for code generation.

Ready to integrate?

API access is included on Enterprise plans. Start a trial to get your API keys.

Get API Access Talk to Engineering