The Samuelz® API provides a comprehensive set of endpoints for integrating our luxury transportation services into your applications. Our RESTful API allows you to manage bookings, track rides, access invoices, and more.
All responses are returned in JSON format. Successful responses will have a 2xx status code, while errors will have a 4xx or 5xx status code.
{
"data": {
// Response data here
},
"meta": {
"request_id": "req_1234567890",
"timestamp": "2025-06-15T14:30:00Z"
}
}Error responses include an error code, message, and additional details when available.
{
"error": {
"code": "invalid_request",
"message": "The request was invalid",
"details": [
{
"field": "pickup.datetime",
"issue": "must be in the future"
}
]
},
"meta": {
"request_id": "req_1234567890",
"timestamp": "2025-06-15T14:30:00Z"
}
}API requests are rate-limited to ensure fair usage. Rate limits vary by endpoint and account tier. Current limits are included in the response headers.
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 98
X-RateLimit-Reset: 1623761400