Endpoints

This page documents the Robo-Hub REST API endpoints.

Note: The API is under active development. Endpoints may change.

Base URL

https://api.robo-hub.t420.io/v1

Authentication

All endpoints require authentication:

Authorization: Bearer <your-token>

---

Zones

List Zones

Get all available zones.

GET /zones

Query Parameters:

Parameter	Type	Description
city	string	Filter by city
region	string	Filter by region

Response:

{
  "zones": [
    {
      "id": "zone_miami_metro",
      "name": "Miami Metro",
      "city": "Miami",
      "supplierCount": 15,
      "categoryCount": 6
    }
  ]
}

Get Zone

Get zone details.

GET /zones/:id

Response:

{
  "id": "zone_miami_metro",
  "name": "Miami Metro",
  "city": "Miami",
  "boundaries": { ... },
  "suppliers": [...],
  "stats": {
    "avgResponseTime": 1.8,
    "slaCompliance": 0.95
  }
}

---

Suppliers

List Suppliers

Search and filter suppliers.

GET /suppliers

Query Parameters:

Parameter	Type	Description
zone	string	Filter by zone ID
category	string	Filter by category
rating	number	Minimum rating
limit	number	Max results

Get Supplier Profile

Get detailed supplier information.

GET /suppliers/:id

Response:

{
  "id": "sup_123",
  "name": "Joe's Mobile Tires",
  "categories": ["tires", "roadside"],
  "zones": ["zone_miami_metro", "zone_miami_beach"],
  "rating": 4.8,
  "services": [...]
}

---

RFQs

Create RFQ

Create a new Request for Quote.

POST /rfqs

Request Body:

{
  "title": "Mobile Tire Service for Miami Fleet",
  "category": "tires",
  "zoneId": "zone_miami_metro",
  "description": "24/7 coverage, <2hr response...",
  "volume": 50,
  "duration": "12_months",
  "deadline": "2026-01-30T00:00:00Z"
}

Response:

{
  "id": "rfq_abc123",
  "status": "OPEN",
  "suppliersNotified": 8,
  "createdAt": "2026-01-18T14:30:00Z"
}

List RFQs

Get RFQs for authenticated user.

GET /rfqs

Query Parameters:

Parameter	Type	Description
status	string	OPEN, EVALUATING, AWARDED, COMPLETED
limit	number	Max results

Get RFQ

Get RFQ details.

GET /rfqs/:id

Submit Quote

Submit a quote for an RFQ (suppliers only).

POST /rfqs/:id/quotes

Request Body:

{
  "pricing": {
    "perService": 65.00,
    "volumeTiers": [...]
  },
  "slaCommitment": {
    "responseTime": 2,
    "availability": "24/7"
  },
  "terms": "Net 30 payment..."
}

List Quotes

Get quotes for an RFQ (RFQ owner only).

GET /rfqs/:id/quotes

---

Contracts

List Contracts

Get active contracts.

GET /contracts

Query Parameters:

Parameter	Type	Description
status	string	DRAFT, ACTIVE, COMPLETED
supplierId	string	Filter by supplier

Get Contract

Get contract details.

GET /contracts/:id

Response:

{
  "id": "cnt_abc123",
  "status": "ACTIVE",
  "supplierId": "sup_123",
  "startDate": "2026-01-01T00:00:00Z",
  "endDate": "2026-12-31T00:00:00Z",
  "terms": {...},
  "sla": {...},
  "performance": {
    "compliance": 0.98,
    "avgResponseTime": 1.8
  }
}

Get Contract Performance

Get SLA performance for a contract.

GET /contracts/:id/performance

Response:

{
  "period": "2026-01",
  "slaCompliance": 0.98,
  "responseTime": {
    "avg": 1.8,
    "p95": 2.5
  },
  "volume": 156,
  "issues": 2
}

---

Webhooks

Configure Webhook

Set up webhook notifications.

POST /webhooks

Request Body:

{
  "url": "https://your-app.com/webhooks",
  "events": [
    "rfq.created",
    "quote.submitted",
    "contract.signed",
    "sla.violation"
  ]
}

Webhook Payload

{
  "event": "quote.submitted",
  "timestamp": "2026-01-18T14:40:00Z",
  "data": {
    "rfqId": "rfq_abc123",
    "quoteId": "quote_xyz789",
    "supplierId": "sup_123"
  }
}

---

Error Responses

Error Format

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The zone field is required"
  }
}

Error Codes

Code	HTTP Status	Description
UNAUTHORIZED	401	Invalid or missing token
FORBIDDEN	403	No permission for action
NOT_FOUND	404	Resource not found
INVALID_REQUEST	400	Invalid request body
RATE_LIMITED	429	Too many requests
SERVER_ERROR	500	Internal error

---

Changelog

Version	Date	Changes
v1.0	2026-01-18	Initial API release

Note: This API documentation is a work in progress. Contact the team for the latest specifications.