{
  "openapi": "3.0.4",
  "info": {
    "title": "Nemtix Scheduler API",
    "description": "Tenant-authenticated JSON scheduling API for validation, analysis, feasibility, synchronous optimization, and durable asynchronous scheduling jobs.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.nemtix.com/"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "tags": [
          "Health"
        ],
        "operationId": "Health",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthLiveResponse"
                }
              }
            }
          }
        }
      }
    },
    "/health/live": {
      "get": {
        "tags": [
          "Health"
        ],
        "operationId": "HealthLive",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthLiveResponse"
                }
              }
            }
          }
        }
      }
    },
    "/health/ready": {
      "get": {
        "tags": [
          "Health"
        ],
        "operationId": "HealthReady",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthReadyResponse"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthReadyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/schedules/validate": {
      "post": {
        "tags": [
          "Schedule"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "application/*\u002Bjson": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleValidationResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "413": {
            "description": "Payload Too Large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedules/analyze": {
      "post": {
        "tags": [
          "Schedule"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "application/*\u002Bjson": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleAnalysisResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "413": {
            "description": "Payload Too Large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "504": {
            "description": "Gateway Timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedules/feasibility": {
      "post": {
        "tags": [
          "Schedule"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "application/*\u002Bjson": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleFeasibilityResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "413": {
            "description": "Payload Too Large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "504": {
            "description": "Gateway Timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedules/optimize": {
      "post": {
        "tags": [
          "Schedule"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "application/*\u002Bjson": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "413": {
            "description": "Payload Too Large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "504": {
            "description": "Gateway Timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedule-jobs": {
      "post": {
        "tags": [
          "ScheduleJob"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            },
            "application/*\u002Bjson": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleJobAcceptedResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "413": {
            "description": "Payload Too Large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedule-jobs/by-request": {
      "get": {
        "tags": [
          "ScheduleJob"
        ],
        "parameters": [
          {
            "name": "requestId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleJobStatusResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedule-jobs/{jobId}": {
      "get": {
        "tags": [
          "ScheduleJob"
        ],
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleJobStatusResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      },
      "delete": {
        "tags": [
          "ScheduleJob"
        ],
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleJobStatusResponse"
                }
              }
            }
          },
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleJobStatusResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    },
    "/api/v1/schedule-jobs/{jobId}/result": {
      "get": {
        "tags": [
          "ScheduleJob"
        ],
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "NemtixApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "AddressDto": {
        "type": "object",
        "properties": {
          "line1": {
            "type": "string",
            "nullable": true
          },
          "line2": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string",
            "nullable": true
          },
          "state": {
            "type": "string",
            "nullable": true
          },
          "postalCode": {
            "type": "string",
            "nullable": true
          },
          "countryCode": {
            "type": "string",
            "nullable": true
          }
        },
        "nullable": true
      },
      "AreaClassification": {
        "enum": [
          "unknown",
          "urban",
          "rural"
        ],
        "type": "string"
      },
      "AssignmentResponse": {
        "required": [
          "tripId",
          "driverId",
          "serviceType"
        ],
        "type": "object",
        "properties": {
          "tripId": {
            "type": "string"
          },
          "driverId": {
            "type": "string"
          },
          "vehicleId": {
            "type": "string",
            "nullable": true
          },
          "serviceType": {
            "type": "string"
          },
          "legType": {
            "$ref": "#/components/schemas/TripLegType"
          },
          "areaClassification": {
            "$ref": "#/components/schemas/AreaClassification"
          },
          "status": {
            "type": "string"
          },
          "pickupSequence": {
            "type": "integer",
            "format": "int32"
          },
          "dropoffSequence": {
            "type": "integer",
            "format": "int32"
          },
          "scheduledPickupDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "scheduledDropoffDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "hasToPickupByDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "estimatedRideMinutes": {
            "type": "number",
            "format": "double"
          },
          "estimatedRideMiles": {
            "type": "number",
            "format": "double"
          },
          "unloadedTravelBeforeMinutes": {
            "type": "number",
            "format": "double"
          },
          "unloadedTravelBeforeMiles": {
            "type": "number",
            "format": "double"
          },
          "multiLoad": {
            "type": "boolean"
          },
          "assignmentStage": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "CapacityDto": {
        "type": "object",
        "properties": {
          "ambulatory": {
            "type": "integer",
            "format": "int32"
          },
          "wheelchair": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "CoverageSettingsRequest": {
        "type": "object",
        "properties": {
          "allowPoorQualityAssignmentForCoverage": {
            "type": "boolean",
            "nullable": true
          }
        },
        "nullable": true
      },
      "DeadheadBudgetMinutesPerTripRequest": {
        "type": "object",
        "properties": {
          "ambulatoryUrban": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "ambulatoryRural": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "wheelchairUrban": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "wheelchairRural": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "DeadheadSettingsRequest": {
        "type": "object",
        "properties": {
          "moderateStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "severeStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "emergencyStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "DriverBreakDto": {
        "required": [
          "breakId",
          "window"
        ],
        "type": "object",
        "properties": {
          "breakId": {
            "type": "string"
          },
          "durationMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "window": {
            "$ref": "#/components/schemas/TimeWindowDto"
          },
          "required": {
            "type": "boolean"
          },
          "requiresEmptyVehicle": {
            "type": "boolean"
          }
        }
      },
      "DriverRequest": {
        "required": [
          "driverId",
          "vehicleType",
          "shift",
          "startLocation"
        ],
        "type": "object",
        "properties": {
          "driverId": {
            "type": "string"
          },
          "vehicleId": {
            "type": "string",
            "nullable": true
          },
          "active": {
            "type": "boolean"
          },
          "vehicleType": {
            "type": "string"
          },
          "capacity": {
            "$ref": "#/components/schemas/CapacityDto"
          },
          "maxWheelchairWidthInches": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "skills": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vehicleCapabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "territories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "shift": {
            "$ref": "#/components/schemas/ShiftDto"
          },
          "breaks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DriverBreakDto"
            }
          },
          "startLocation": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "endLocation": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/LocationDto"
              }
            ]
          },
          "returnToEndLocation": {
            "type": "boolean"
          },
          "maxTrips": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EffectiveCoverageSettingsResponse": {
        "type": "object",
        "properties": {
          "allowPoorQualityAssignmentForCoverage": {
            "type": "boolean"
          }
        }
      },
      "EffectiveDeadheadBudgetMinutesPerTripResponse": {
        "type": "object",
        "properties": {
          "ambulatoryUrban": {
            "type": "number",
            "format": "double"
          },
          "ambulatoryRural": {
            "type": "number",
            "format": "double"
          },
          "wheelchairUrban": {
            "type": "number",
            "format": "double"
          },
          "wheelchairRural": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "EffectiveDeadheadSettingsResponse": {
        "type": "object",
        "properties": {
          "moderateStartMinutes": {
            "type": "number",
            "format": "double"
          },
          "severeStartMinutes": {
            "type": "number",
            "format": "double"
          },
          "emergencyStartMinutes": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "EffectiveExcursionSettingsResponse": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "preferredMaximumInterTripDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumInterTripDeadheadMinutes": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "EffectiveHomeAreaSettingsResponse": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "preferredRadiusMinutes": {
            "type": "number",
            "format": "double"
          },
          "penaltyStartMinutes": {
            "type": "number",
            "format": "double"
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "EffectiveOptimizationSettingsResponse": {
        "required": [
          "profile",
          "routeQuality"
        ],
        "type": "object",
        "properties": {
          "profile": {
            "type": "string"
          },
          "routeQuality": {
            "$ref": "#/components/schemas/EffectiveRouteQualitySettingsResponse"
          }
        }
      },
      "EffectiveRouteDeadheadBudgetSettingsResponse": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "tier1ExtraMinutes": {
            "type": "number",
            "format": "double"
          },
          "dynamicBackstop": {
            "type": "boolean"
          },
          "backstopMarginMinutes": {
            "type": "number",
            "format": "double"
          },
          "absoluteBackstopMinutes": {
            "type": "number",
            "format": "double"
          },
          "returnHomeMinuteWeight": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "EffectiveRouteDensitySettingsResponse": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "preferExistingRoutes": {
            "type": "boolean"
          },
          "preferredMaximumAddedDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "EffectiveRouteQualitySettingsResponse": {
        "required": [
          "deadheadBudgetMinutesPerTrip",
          "deadhead",
          "waiting",
          "homeArea",
          "routeDensity",
          "routeDeadheadBudget",
          "excursion",
          "coverage"
        ],
        "type": "object",
        "properties": {
          "deadheadBudgetMinutesPerTrip": {
            "$ref": "#/components/schemas/EffectiveDeadheadBudgetMinutesPerTripResponse"
          },
          "deadhead": {
            "$ref": "#/components/schemas/EffectiveDeadheadSettingsResponse"
          },
          "maximumSingleDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "waiting": {
            "$ref": "#/components/schemas/EffectiveWaitingSettingsResponse"
          },
          "homeArea": {
            "$ref": "#/components/schemas/EffectiveHomeAreaSettingsResponse"
          },
          "routeDensity": {
            "$ref": "#/components/schemas/EffectiveRouteDensitySettingsResponse"
          },
          "routeDeadheadBudget": {
            "$ref": "#/components/schemas/EffectiveRouteDeadheadBudgetSettingsResponse"
          },
          "excursion": {
            "$ref": "#/components/schemas/EffectiveExcursionSettingsResponse"
          },
          "coverage": {
            "$ref": "#/components/schemas/EffectiveCoverageSettingsResponse"
          }
        }
      },
      "EffectiveWaitingSettingsResponse": {
        "type": "object",
        "properties": {
          "preferredMaximumWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "ErrorResponse": {
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "requestId": {
            "type": "string",
            "nullable": true
          },
          "traceId": {
            "type": "string",
            "nullable": true
          },
          "retryable": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationErrorResponse"
            }
          }
        }
      },
      "ErrorResponse2": {
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "requestId": {
            "type": "string",
            "nullable": true
          },
          "traceId": {
            "type": "string",
            "nullable": true
          },
          "retryable": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationErrorResponse"
            }
          }
        },
        "nullable": true
      },
      "ExcursionSettingsRequest": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "nullable": true
          },
          "preferredMaximumInterTripDeadheadMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "maximumInterTripDeadheadMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "FeasibleInsertionResponse": {
        "required": [
          "driverId"
        ],
        "type": "object",
        "properties": {
          "driverId": {
            "type": "string"
          },
          "vehicleId": {
            "type": "string",
            "nullable": true
          },
          "pickupInsertionIndex": {
            "type": "integer",
            "format": "int32"
          },
          "dropoffInsertionIndex": {
            "type": "integer",
            "format": "int32"
          },
          "scheduledPickupDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "scheduledDropoffDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "routeEndDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "rideMinutes": {
            "type": "number",
            "format": "double"
          },
          "addedTravelMinutes": {
            "type": "number",
            "format": "double"
          },
          "addedTravelMiles": {
            "type": "number",
            "format": "double"
          },
          "addedUnloadedMinutes": {
            "type": "number",
            "format": "double"
          },
          "addedUnloadedMiles": {
            "type": "number",
            "format": "double"
          },
          "travelBeforePickupMinutes": {
            "type": "number",
            "format": "double"
          },
          "travelBeforePickupMiles": {
            "type": "number",
            "format": "double"
          },
          "routeStops": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RouteStopResponse"
            }
          }
        },
        "nullable": true
      },
      "HealthLiveResponse": {
        "required": [
          "status",
          "service",
          "apiVersion",
          "engineVersion",
          "utc"
        ],
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "service": {
            "type": "string"
          },
          "apiVersion": {
            "type": "string"
          },
          "engineVersion": {
            "type": "string"
          },
          "utc": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "HealthReadyResponse": {
        "required": [
          "status",
          "service",
          "apiVersion",
          "engineVersion",
          "routing",
          "utc"
        ],
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "service": {
            "type": "string"
          },
          "apiVersion": {
            "type": "string"
          },
          "engineVersion": {
            "type": "string"
          },
          "routing": {
            "$ref": "#/components/schemas/RoutingReadinessResponse"
          },
          "utc": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "HomeAreaSettingsRequest": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "nullable": true
          },
          "preferredRadiusMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "penaltyStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "LocationDto": {
        "required": [
          "latitude",
          "longitude"
        ],
        "type": "object",
        "properties": {
          "locationId": {
            "type": "string",
            "nullable": true
          },
          "address": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "OptimizationSettingsRequest": {
        "type": "object",
        "properties": {
          "routeQuality": {
            "$ref": "#/components/schemas/RouteQualitySettingsRequest"
          }
        },
        "nullable": true
      },
      "PassengerLoadDto": {
        "type": "object",
        "properties": {
          "ambulatory": {
            "type": "integer",
            "format": "int32"
          },
          "wheelchair": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "RouteDeadheadBudgetSettingsRequest": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "nullable": true
          },
          "tier1ExtraMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "dynamicBackstop": {
            "type": "boolean",
            "nullable": true
          },
          "backstopMarginMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "absoluteBackstopMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "returnHomeMinuteWeight": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "RouteDensitySettingsRequest": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "nullable": true
          },
          "preferExistingRoutes": {
            "type": "boolean",
            "nullable": true
          },
          "preferredMaximumAddedDeadheadMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "RouteEventType": {
        "enum": [
          "start",
          "pickup",
          "dropoff",
          "gap",
          "break",
          "end"
        ],
        "type": "string"
      },
      "RouteQualitySettingsRequest": {
        "type": "object",
        "properties": {
          "deadheadBudgetMinutesPerTrip": {
            "$ref": "#/components/schemas/DeadheadBudgetMinutesPerTripRequest"
          },
          "deadhead": {
            "$ref": "#/components/schemas/DeadheadSettingsRequest"
          },
          "maximumSingleDeadheadMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "waiting": {
            "$ref": "#/components/schemas/WaitingSettingsRequest"
          },
          "homeArea": {
            "$ref": "#/components/schemas/HomeAreaSettingsRequest"
          },
          "routeDensity": {
            "$ref": "#/components/schemas/RouteDensitySettingsRequest"
          },
          "routeDeadheadBudget": {
            "$ref": "#/components/schemas/RouteDeadheadBudgetSettingsRequest"
          },
          "excursion": {
            "$ref": "#/components/schemas/ExcursionSettingsRequest"
          },
          "coverage": {
            "$ref": "#/components/schemas/CoverageSettingsRequest"
          }
        },
        "nullable": true
      },
      "RouteResponse": {
        "required": [
          "driverId",
          "vehicleType",
          "shift"
        ],
        "type": "object",
        "properties": {
          "driverId": {
            "type": "string"
          },
          "vehicleId": {
            "type": "string",
            "nullable": true
          },
          "vehicleType": {
            "type": "string"
          },
          "shift": {
            "$ref": "#/components/schemas/ShiftDto"
          },
          "summary": {
            "$ref": "#/components/schemas/RouteSummaryResponse"
          },
          "stops": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RouteStopResponse"
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "RouteStopResponse": {
        "required": [
          "location"
        ],
        "type": "object",
        "properties": {
          "sequence": {
            "type": "integer",
            "format": "int32"
          },
          "eventType": {
            "$ref": "#/components/schemas/RouteEventType"
          },
          "tripId": {
            "type": "string",
            "nullable": true
          },
          "serviceType": {
            "type": "string",
            "nullable": true
          },
          "breakId": {
            "type": "string",
            "nullable": true
          },
          "scheduledDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "arrivalDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "departureDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "startDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "endDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "durationMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "location": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "travelFromPrevious": {
            "$ref": "#/components/schemas/TravelLegDto"
          },
          "waitMinutes": {
            "type": "number",
            "format": "double"
          },
          "lateMinutes": {
            "type": "number",
            "format": "double"
          },
          "loadAfterStop": {
            "$ref": "#/components/schemas/PassengerLoadDto"
          },
          "violations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "RouteSummaryResponse": {
        "type": "object",
        "properties": {
          "tripCount": {
            "type": "integer",
            "format": "int32"
          },
          "stopCount": {
            "type": "integer",
            "format": "int32"
          },
          "routeStart": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "routeEnd": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "loadedMiles": {
            "type": "number",
            "format": "double"
          },
          "unloadedMiles": {
            "type": "number",
            "format": "double"
          },
          "loadedMinutes": {
            "type": "number",
            "format": "double"
          },
          "unloadedMinutes": {
            "type": "number",
            "format": "double"
          },
          "serviceDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "serviceDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "outboundDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "outboundDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "interTripDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "interTripDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumInterTripDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "homeDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "homeDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "worstDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "preServiceIdleMinutes": {
            "type": "number",
            "format": "double"
          },
          "totalInterTripWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumInterTripWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumServiceFromStartMinutes": {
            "type": "number",
            "format": "double"
          },
          "equivalentEmptyMinutes": {
            "type": "number",
            "format": "double"
          },
          "deadheadBudgetMinutes": {
            "type": "number",
            "format": "double"
          },
          "deadheadTier1LimitMinutes": {
            "type": "number",
            "format": "double"
          },
          "dynamicDeadheadBackstopMinutes": {
            "type": "number",
            "format": "double"
          },
          "multiLoadTrips": {
            "type": "integer",
            "format": "int32"
          },
          "latePickups": {
            "type": "integer",
            "format": "int32"
          },
          "lateDropoffs": {
            "type": "integer",
            "format": "int32"
          },
          "maximumLateMinutes": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "RoutingAnalysisResponse": {
        "type": "object",
        "properties": {
          "attempted": {
            "type": "boolean"
          },
          "succeeded": {
            "type": "boolean"
          },
          "uniqueLocationCount": {
            "type": "integer",
            "format": "int32"
          },
          "matrixRows": {
            "type": "integer",
            "format": "int32"
          },
          "matrixColumns": {
            "type": "integer",
            "format": "int32"
          },
          "routingRequests": {
            "type": "integer",
            "format": "int32"
          },
          "routingRetries": {
            "type": "integer",
            "format": "int32"
          },
          "unreachablePairs": {
            "type": "integer",
            "format": "int64"
          },
          "runtimeMilliseconds": {
            "type": "integer",
            "format": "int64"
          },
          "errorCode": {
            "type": "string",
            "nullable": true
          },
          "errorMessage": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "RoutingReadinessResponse": {
        "required": [
          "status",
          "runtimeMilliseconds"
        ],
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "runtimeMilliseconds": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "ScheduleAnalysisResponse": {
        "required": [
          "requestId",
          "runId",
          "engineVersion"
        ],
        "type": "object",
        "properties": {
          "apiVersion": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "runId": {
            "type": "string"
          },
          "engineVersion": {
            "type": "string"
          },
          "generatedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "driverCount": {
            "type": "integer",
            "format": "int32"
          },
          "activeDriverCount": {
            "type": "integer",
            "format": "int32"
          },
          "tripCount": {
            "type": "integer",
            "format": "int32"
          },
          "driverTripPairsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "compatibleDriverTripPairs": {
            "type": "integer",
            "format": "int64"
          },
          "tripsWithCompatibleDriver": {
            "type": "integer",
            "format": "int32"
          },
          "tripsWithoutCompatibleDriver": {
            "type": "integer",
            "format": "int32"
          },
          "compatibilityFailureCounts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "trips": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TripCompatibilityAnalysisResponse"
            }
          },
          "routing": {
            "$ref": "#/components/schemas/RoutingAnalysisResponse"
          }
        }
      },
      "ScheduleDiagnosticsResponse": {
        "type": "object",
        "properties": {
          "runtimeMilliseconds": {
            "type": "integer",
            "format": "int64"
          },
          "candidatePairsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "candidateInsertionsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "candidateInsertionsPruned": {
            "type": "integer",
            "format": "int64"
          },
          "fastPrecheckRejectedPairs": {
            "type": "integer",
            "format": "int64"
          },
          "exhaustiveInsertionFallbacks": {
            "type": "integer",
            "format": "int64"
          },
          "feasibleInsertions": {
            "type": "integer",
            "format": "int64"
          },
          "routeQualityRejectedInsertions": {
            "type": "integer",
            "format": "int64"
          },
          "dynamicDeadheadBackstopRejectedInsertions": {
            "type": "integer",
            "format": "int64"
          },
          "excursionRejectedInsertions": {
            "type": "integer",
            "format": "int64"
          },
          "routingRequests": {
            "type": "integer",
            "format": "int32"
          },
          "routingRetries": {
            "type": "integer",
            "format": "int32"
          },
          "routingLocations": {
            "type": "integer",
            "format": "int32"
          },
          "regretTripsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "regretCandidatePairsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "recoveryTripsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "recoveryCandidatePairsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "recoveryPassesAttempted": {
            "type": "integer",
            "format": "int32"
          },
          "recoverySuccesses": {
            "type": "integer",
            "format": "int32"
          },
          "assignedBeforeRecovery": {
            "type": "integer",
            "format": "int32"
          },
          "assignedAfterRecovery": {
            "type": "integer",
            "format": "int32"
          },
          "coverageBeforeRecoveryPercent": {
            "type": "number",
            "format": "double"
          },
          "coverageAfterRecoveryPercent": {
            "type": "number",
            "format": "double"
          },
          "assignedBeforeRepair": {
            "type": "integer",
            "format": "int32"
          },
          "assignedAfterRepair": {
            "type": "integer",
            "format": "int32"
          },
          "coverageBeforeRepairPercent": {
            "type": "number",
            "format": "double"
          },
          "coverageAfterRepairPercent": {
            "type": "number",
            "format": "double"
          },
          "repairPassesAttempted": {
            "type": "integer",
            "format": "int32"
          },
          "repairTripsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "repairTargetRoutesEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "repairEjectionCandidatesEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "repairReinsertionPairsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "repairTargetInsertionsFeasible": {
            "type": "integer",
            "format": "int64"
          },
          "repairReinsertionsFeasible": {
            "type": "integer",
            "format": "int64"
          },
          "repairCostGuardrailRejections": {
            "type": "integer",
            "format": "int64"
          },
          "repairUnloadedGuardrailRejections": {
            "type": "integer",
            "format": "int64"
          },
          "repairSuccesses": {
            "type": "integer",
            "format": "int32"
          },
          "repairTripsRecovered": {
            "type": "integer",
            "format": "int32"
          },
          "repairTripsRelocated": {
            "type": "integer",
            "format": "int32"
          },
          "repairTripsReordered": {
            "type": "integer",
            "format": "int32"
          },
          "repairWeightedCostDelta": {
            "type": "number",
            "format": "double"
          },
          "repairAddedUnloadedMinutes": {
            "type": "number",
            "format": "double"
          },
          "rebalanceTripsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "rebalanceMovesEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "rebalanceSuccesses": {
            "type": "integer",
            "format": "int32"
          },
          "rebalanceWeightedCostImprovement": {
            "type": "number",
            "format": "double"
          },
          "rebalanceUnloadedMinutesSaved": {
            "type": "number",
            "format": "double"
          },
          "assignmentsByStage": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "constraintFailureCounts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "stageRuntimeMilliseconds": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int64"
            }
          }
        },
        "nullable": true
      },
      "ScheduleFeasibilityResponse": {
        "required": [
          "requestId",
          "runId",
          "engineVersion"
        ],
        "type": "object",
        "properties": {
          "apiVersion": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "runId": {
            "type": "string"
          },
          "engineVersion": {
            "type": "string"
          },
          "generatedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "routeContext": {
            "type": "string"
          },
          "driverCount": {
            "type": "integer",
            "format": "int32"
          },
          "activeDriverCount": {
            "type": "integer",
            "format": "int32"
          },
          "tripCount": {
            "type": "integer",
            "format": "int32"
          },
          "tripsWithCompatibleDriver": {
            "type": "integer",
            "format": "int32"
          },
          "tripsWithFeasibleDriver": {
            "type": "integer",
            "format": "int32"
          },
          "tripsWithoutFeasibleDriver": {
            "type": "integer",
            "format": "int32"
          },
          "driverTripPairsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "candidateInsertionsEvaluated": {
            "type": "integer",
            "format": "int64"
          },
          "feasibleInsertions": {
            "type": "integer",
            "format": "int64"
          },
          "constraintFailureCounts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "routing": {
            "$ref": "#/components/schemas/RoutingAnalysisResponse"
          },
          "trips": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TripFeasibilityResponse"
            }
          }
        }
      },
      "ScheduleJobAcceptedResponse": {
        "required": [
          "jobId",
          "requestId",
          "status",
          "engineVersion",
          "statusUrl",
          "resultUrl"
        ],
        "type": "object",
        "properties": {
          "apiVersion": {
            "type": "string"
          },
          "jobId": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "engineVersion": {
            "type": "string"
          },
          "submittedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "statusUrl": {
            "type": "string"
          },
          "resultUrl": {
            "type": "string"
          }
        }
      },
      "ScheduleJobCompletionSummaryResponse": {
        "type": "object",
        "properties": {
          "assignedTrips": {
            "type": "integer",
            "format": "int32"
          },
          "unassignedTrips": {
            "type": "integer",
            "format": "int32"
          },
          "coveragePercent": {
            "type": "number",
            "format": "double"
          },
          "driversUsed": {
            "type": "integer",
            "format": "int32"
          },
          "runtimeMilliseconds": {
            "type": "integer",
            "format": "int64"
          }
        },
        "nullable": true
      },
      "ScheduleJobStatusResponse": {
        "required": [
          "jobId",
          "requestId",
          "providerId",
          "optimizationProfile",
          "status",
          "engineVersion",
          "statusUrl",
          "resultUrl"
        ],
        "type": "object",
        "properties": {
          "apiVersion": {
            "type": "string"
          },
          "jobId": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "providerId": {
            "type": "string"
          },
          "serviceDate": {
            "type": "string",
            "format": "date"
          },
          "optimizationProfile": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "engineVersion": {
            "type": "string"
          },
          "runId": {
            "type": "string",
            "nullable": true
          },
          "submittedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "startedAtUtc": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAtUtc": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "cancellationRequestedAtUtc": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "expiresAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "driverCount": {
            "type": "integer",
            "format": "int32"
          },
          "tripCount": {
            "type": "integer",
            "format": "int32"
          },
          "resultAvailable": {
            "type": "boolean"
          },
          "retryable": {
            "type": "boolean"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorResponse2"
          },
          "summary": {
            "$ref": "#/components/schemas/ScheduleJobCompletionSummaryResponse"
          },
          "statusUrl": {
            "type": "string"
          },
          "resultUrl": {
            "type": "string"
          }
        }
      },
      "ScheduleOptionsRequest": {
        "type": "object",
        "properties": {
          "includeDiagnostics": {
            "type": "boolean"
          },
          "seed": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        }
      },
      "ScheduleRequest": {
        "required": [
          "requestId",
          "providerId",
          "serviceDate",
          "timeZone"
        ],
        "type": "object",
        "properties": {
          "apiVersion": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "providerId": {
            "type": "string"
          },
          "serviceDate": {
            "type": "string",
            "format": "date"
          },
          "timeZone": {
            "type": "string"
          },
          "optimizationProfile": {
            "type": "string"
          },
          "optimizationSettings": {
            "$ref": "#/components/schemas/OptimizationSettingsRequest"
          },
          "options": {
            "$ref": "#/components/schemas/ScheduleOptionsRequest"
          },
          "drivers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DriverRequest"
            }
          },
          "trips": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TripRequest"
            }
          }
        }
      },
      "ScheduleResponse": {
        "required": [
          "requestId",
          "runId",
          "serviceDate",
          "timeZone",
          "optimizationProfile",
          "effectiveOptimizationSettings"
        ],
        "type": "object",
        "properties": {
          "apiVersion": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          },
          "runId": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/ScheduleStatus"
          },
          "engineVersion": {
            "type": "string"
          },
          "generatedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "serviceDate": {
            "type": "string",
            "format": "date"
          },
          "timeZone": {
            "type": "string"
          },
          "optimizationProfile": {
            "type": "string"
          },
          "effectiveOptimizationSettings": {
            "$ref": "#/components/schemas/EffectiveOptimizationSettingsResponse"
          },
          "summary": {
            "$ref": "#/components/schemas/ScheduleSummaryResponse"
          },
          "routes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RouteResponse"
            }
          },
          "assignments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssignmentResponse"
            }
          },
          "unassigned": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UnassignedTripResponse"
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "diagnostics": {
            "$ref": "#/components/schemas/ScheduleDiagnosticsResponse"
          }
        }
      },
      "ScheduleStatus": {
        "enum": [
          "completed",
          "failed"
        ],
        "type": "string"
      },
      "ScheduleSummaryResponse": {
        "type": "object",
        "properties": {
          "totalTrips": {
            "type": "integer",
            "format": "int32"
          },
          "assignedTrips": {
            "type": "integer",
            "format": "int32"
          },
          "unassignedTrips": {
            "type": "integer",
            "format": "int32"
          },
          "coveragePercent": {
            "type": "number",
            "format": "double"
          },
          "driversAvailable": {
            "type": "integer",
            "format": "int32"
          },
          "driversUsed": {
            "type": "integer",
            "format": "int32"
          },
          "serviceTypes": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ServiceTypeSummaryResponse"
            }
          },
          "totalLoadedMiles": {
            "type": "number",
            "format": "double"
          },
          "totalUnloadedMiles": {
            "type": "number",
            "format": "double"
          },
          "totalLoadedMinutes": {
            "type": "number",
            "format": "double"
          },
          "totalUnloadedMinutes": {
            "type": "number",
            "format": "double"
          },
          "serviceDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "serviceDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "outboundDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "outboundDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "interTripDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "interTripDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "homeDeadheadMiles": {
            "type": "number",
            "format": "double"
          },
          "homeDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "multiLoadTrips": {
            "type": "integer",
            "format": "int32"
          },
          "multiLoadPercent": {
            "type": "number",
            "format": "double"
          },
          "latePickups": {
            "type": "integer",
            "format": "int32"
          },
          "lateDropoffs": {
            "type": "integer",
            "format": "int32"
          },
          "averageLateMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumLateMinutes": {
            "type": "number",
            "format": "double"
          },
          "worstDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "totalPreServiceIdleMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumPreServiceIdleMinutes": {
            "type": "number",
            "format": "double"
          },
          "totalInterTripWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumInterTripWaitMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumServiceFromStartMinutes": {
            "type": "number",
            "format": "double"
          },
          "maximumInterTripDeadheadMinutes": {
            "type": "number",
            "format": "double"
          },
          "totalEquivalentEmptyMinutes": {
            "type": "number",
            "format": "double"
          },
          "deadheadOver30Minutes": {
            "type": "integer",
            "format": "int32"
          },
          "deadheadOver45Minutes": {
            "type": "integer",
            "format": "int32"
          },
          "deadheadOver60Minutes": {
            "type": "integer",
            "format": "int32"
          },
          "deadheadOver90Minutes": {
            "type": "integer",
            "format": "int32"
          },
          "deadheadOver120Minutes": {
            "type": "integer",
            "format": "int32"
          },
          "runtimeMilliseconds": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "ScheduleValidationResponse": {
        "type": "object",
        "properties": {
          "valid": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationErrorResponse"
            }
          }
        }
      },
      "ServiceTypeSummaryResponse": {
        "type": "object",
        "properties": {
          "totalTrips": {
            "type": "integer",
            "format": "int32"
          },
          "assignedTrips": {
            "type": "integer",
            "format": "int32"
          },
          "unassignedTrips": {
            "type": "integer",
            "format": "int32"
          },
          "coveragePercent": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "ShiftDto": {
        "required": [
          "start",
          "end"
        ],
        "type": "object",
        "properties": {
          "start": {
            "type": "string",
            "format": "date-time"
          },
          "end": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "TimeWindowDto": {
        "type": "object",
        "properties": {
          "earliest": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "latest": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "TimeWindowDto2": {
        "type": "object",
        "properties": {
          "earliest": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "latest": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "nullable": true
      },
      "TravelLegDto": {
        "type": "object",
        "properties": {
          "minutes": {
            "type": "number",
            "format": "double"
          },
          "miles": {
            "type": "number",
            "format": "double"
          },
          "loaded": {
            "type": "boolean"
          }
        },
        "nullable": true
      },
      "TripCompatibilityAnalysisResponse": {
        "required": [
          "tripId",
          "serviceType"
        ],
        "type": "object",
        "properties": {
          "tripId": {
            "type": "string"
          },
          "serviceType": {
            "type": "string"
          },
          "compatibleDriverCount": {
            "type": "integer",
            "format": "int32"
          },
          "compatibleDriverIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "failureCounts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          }
        }
      },
      "TripFeasibilityResponse": {
        "required": [
          "tripId",
          "serviceType"
        ],
        "type": "object",
        "properties": {
          "tripId": {
            "type": "string"
          },
          "serviceType": {
            "type": "string"
          },
          "compatibleDriverCount": {
            "type": "integer",
            "format": "int32"
          },
          "feasibleDriverCount": {
            "type": "integer",
            "format": "int32"
          },
          "feasibleDriverIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "bestInsertion": {
            "$ref": "#/components/schemas/FeasibleInsertionResponse"
          },
          "staticFailureCounts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "constraintFailureCounts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          }
        }
      },
      "TripLegType": {
        "enum": [
          "standalone",
          "outbound",
          "return"
        ],
        "type": "string"
      },
      "TripRequest": {
        "required": [
          "tripId",
          "serviceType",
          "pickup",
          "dropoff"
        ],
        "type": "object",
        "properties": {
          "tripId": {
            "type": "string"
          },
          "tripGroupId": {
            "type": "string",
            "nullable": true
          },
          "linkedTripId": {
            "type": "string",
            "nullable": true
          },
          "legType": {
            "$ref": "#/components/schemas/TripLegType"
          },
          "serviceType": {
            "type": "string"
          },
          "priority": {
            "type": "integer",
            "format": "int32"
          },
          "territory": {
            "type": "string",
            "nullable": true
          },
          "areaClassification": {
            "$ref": "#/components/schemas/AreaClassification"
          },
          "pickup": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "dropoff": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "requestedPickupDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "appointmentDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "pickupWindow": {
            "$ref": "#/components/schemas/TimeWindowDto2"
          },
          "dropoffWindow": {
            "$ref": "#/components/schemas/TimeWindowDto2"
          },
          "hasToPickupByDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "maxRideMinutes": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "pickupServiceMinutes": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "dropoffServiceMinutes": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "passengerLoad": {
            "$ref": "#/components/schemas/PassengerLoadDto"
          },
          "wheelchair": {
            "$ref": "#/components/schemas/WheelchairRequirementDto"
          },
          "requiredDriverSkills": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "requiredVehicleCapabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "mustRideAlone": {
            "type": "boolean"
          },
          "allowMultiLoad": {
            "type": "boolean"
          },
          "lockedDriverId": {
            "type": "string",
            "nullable": true
          },
          "excludedDriverIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "isWillCall": {
            "type": "boolean"
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "UnassignedReasonResponse": {
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "UnassignedTripResponse": {
        "required": [
          "tripId",
          "serviceType"
        ],
        "type": "object",
        "properties": {
          "tripId": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "serviceType": {
            "type": "string"
          },
          "legType": {
            "$ref": "#/components/schemas/TripLegType"
          },
          "areaClassification": {
            "$ref": "#/components/schemas/AreaClassification"
          },
          "priority": {
            "type": "integer",
            "format": "int32"
          },
          "requestedPickupDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "appointmentDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "hasToPickupByDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "reasons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UnassignedReasonResponse"
            }
          },
          "constraintFailures": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          }
        }
      },
      "ValidationErrorResponse": {
        "required": [
          "path",
          "code",
          "message"
        ],
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "WaitingSettingsRequest": {
        "type": "object",
        "properties": {
          "preferredMaximumWaitMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "strongPenaltyStartMinutes": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "nullable": true
      },
      "WheelchairRequirementDto": {
        "type": "object",
        "properties": {
          "required": {
            "type": "boolean"
          },
          "widthInches": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        }
      }
    },
    "securitySchemes": {
      "NemtixApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Nemtix-Api-Key",
        "description": "Tenant-scoped Nemtix API key. API keys are mapped server-side to a tenant and an allowed providerId set."
      }
    }
  },
  "tags": [
    {
      "name": "Health"
    },
    {
      "name": "Schedule"
    },
    {
      "name": "ScheduleJob"
    }
  ]
}