How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Optibus Driver Absences API

API endpoints for managing absences for drivers - i.e. periods where they are unavailable for work.

Optibus Driver Absences API is one of 26 APIs that Optibus publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Driver Absences. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 5 operations across 4 paths, and defines 52 schemas. It is described by OpenAPI 3.0.0, at version 2.8.17.

Requests are made against a single base URL, https://YOUR-OPTIBUS-ACCOUNT.api.ops.optibus.co.

5 operations 4 paths 52 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.8.17
Base URL
https://your-optibus-account.api.ops.optibus.co
Authentication
API Key
License
Optibus Ltd, All rights reserved
Resource Areas
1

Authentication & Security 1

Optibus Driver Absences API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (api_key).

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Driver Absences 5

API endpoints for managing absences for drivers - i.e. periods where they are unavailable for work.

GET
/v2/drivers/absences
List driver absences
GetAbsencesV2 5 params → 200400404
POST
/v1/absences
Create/update driver absences
PostDriverAbsences 1 param body → 200400422
GET
/v1/drivers/time-off-balances
List driver time-off balances
GetTimeOffBalances 3 params → 200414
POST
/v1/drivers/time-off-balances
Create/update driver time-off balances
PutTimeOffBalances body → 200400
POST
/v1/drivers/absence-quotas-query
List absence quota usage
GetAbsenceQuotas body → 200400

Schemas 52

The contract defines 52 schemas that model the data the API accepts and returns. The most detailed are DriverAbsenceV2 (11 properties), AbsenceQuotaWithUsage (8 properties), TimeOffBankBalance (8 properties), BaseAbsenceTime (6 properties). Each schema is shown below with its type and property counts.

DayUsage
object
One calendar day: actual daily used + effective limit (after exceptions, scope).
2 properties 2 required
TypedApiErrorResponse_Invalidrequestschema_
object
1 property 1 required
TypedApiErrorResponse_PostDriverAbsencesErrorTypes_
object
1 property 1 required
AbsenceQuotasMeta
object
4 properties 4 required
TypedErrorResponse_GetAbsencesV2ErrorTypes_
object
3 properties 2 required
Record_string.WeekUsage_
object
Construct a type with a set of properties K of type T
CalculationTimeFrame
string
QuotaUsage
object
4 properties 2 required
PostDriverAbsencesSuccess
object
UUID
string
Stringified ID for a resource. Cannot exceed 36 characters.
ScheduledPayoutType
string
PayoutData
object
3 properties 3 required
TypedErrorResponse_Invalidrequestschema_
object
3 properties 2 required
Pagination
object
Metadata about the pagination of a list of items. When a list of items is too large to be returned in a single response, it is split into multiple pages. This…
3 properties 2 required
UnitQuotaDef
object
Unit-level quota definition inside the API response (distinct from the preference-stored UnitQuota).
2 properties 2 required
SameDayMinutesFromMidnightTime
integer
Same-calendar-day wall clock time, represented as minutes since midnight. For example, 0 is midnight (start of the day), 120 is 02:00 (2 hours after midnight),…
PageNumber
Page number (1-indexed). Defaults to 1.
PostDriverAbsencesErrorTypes
string
GetAbsencesV2SuccessfulResponse
object
2 properties 2 required
TypedApiErrorResponse_GetAbsencesV2ErrorTypes_
object
1 property 1 required
BaseAbsenceTime
object
6 properties 1 required
TimeOffBankBalance
object
8 properties 7 required
Record_StringifyDate.PayoutData-Array_
object
Construct a type with a set of properties K of type T
Record_string.Record_string._used-number___
object
Construct a type with a set of properties K of type T
ResponseDepotQuota
object
3 properties 2 required
PostDriverAbsencesErrorResponse
Record_string._used-number__
object
Construct a type with a set of properties K of type T
DriverAbsenceV2
object
A single driver absence record in the V2 response format
11 properties 4 required
GetAbsenceQuotasRequest
object
4 properties 2 required
UnitQuotaUsage
object
3 properties 2 required
DriverAbsence
PostDriverAbsencesRequest
array
TimeOffBankHistoricalBalance
object
2 properties 2 required
TypedErrorResponse_PostDriverAbsencesErrorTypes_
object
3 properties 2 required
AbsenceQuotaWithUsage
object
Quota config from preferences (base depot + unit rows). Effective caps after exceptions and scope are in usage.byDay / usage.byWeek (and usage.byUnit).
8 properties 8 required
TimeOffBalanceRecord
object
5 properties 4 required
Record_string.UnitQuotaUsage_
object
Construct a type with a set of properties K of type T
TimeOffBalances
object
2 properties 2 required
Integer
integer
GetAbsencesV2ErrorResponse
WeekUsage
object
Roll-up for a calendar week overlapping meta.from…meta.to. Key = week-start Monday YYYY-MM-DD.
2 properties 2 required
LegacyImportErrorResponse
object
2 properties 2 required
GetAbsencesV2ErrorTypes
string
StringifyDate
string
Stringified ISO8601 date in the form of YYYY-MM-dd, for example 2017-07-21
SchemaValidationErrorResponse
StringifyDateTime
string
Stringified date-time. date-time notation as defined by [RFC 3339](https://tools.ietf.org/html/rfc3339section-5.6), section 5.6, for example,2017-07-21T17:32:2…
PutTimeOffBalancesRequest
object
2 properties 1 required
PutTimeOffBalancesResponse
object
GetTimeOffBalancesResponse
array
Collection of time off balances for requested drivers
BaseAbsence
GetAbsenceQuotasResponse
object
2 properties 2 required
Record_string.DayUsage_
object
Construct a type with a set of properties K of type T

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

optibus-driver-absences-api-openapi.yml Raw ↑

Other APIs Optibus publishes across the network.

Optibus Driver App Notifications API
Optibus Driver Custom Attributes API
Optibus Driver Employment Periods API
Optibus Driver Groups API
Optibus Driver Volunteering Periods API
Optibus Drivers API
Optibus Drivers (Deprecated) API
Optibus Event Webhooks API
Optibus Operational Plan API
Optibus Operational Plan (Deprecated) API
Optibus Payroll API
Optibus Preferences API
Where this information came from

This is an independent, third-party profile of Optibus Driver Absences API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.