---
updatedAt: 2026-09-23T20:15:10.000Z
agentTools:
  projectIndex: https://mediroutes-api.readme.io/llms.txt
---

# Get Trip Status By Trip Guid

Get trip status by trip Guid

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "V1",
    "title": "MediroutesAPI V1"
  },
  "paths": {
    "/api/v{version}/tripstatus/getTripStatusByTripGuid": {
      "get": {
        "tags": [
          "TripStatus"
        ],
        "summary": "Get Trip Status By Trip Guid",
        "description": "Get trip status by trip Guid",
        "operationId": "get-tripstatusByTripGuid",
        "parameters": [
          {
            "name": "trip_guid",
            "in": "query",
            "description": "",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "apiKey",
            "in": "query",
            "description": "",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "access token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Trip Status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripStatusModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripStatusModel"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/TripStatusModel"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/TripStatusModel"
                }
              }
            }
          },
          "400": {
            "description": "Missing or unaligned data. Error message will be returned with response."
          },
          "403": {
            "description": "The api key used does not have access to this resource."
          }
        },
        "x-ai-description": "Returns the current live status of one trip looked up by its internal trip GUID: trip state, scheduled/actual times, and assigned driver and vehicle when on a run.",
        "x-ai-when-to-use": "The user asks about a ride's status and you hold the trip GUID (from trip creation or rides/queryByFsid).",
        "x-ai-side-effects": "read-only",
        "x-ai-returns": "A TripStatusModel: status, times, driver and vehicle details, and tracking info for the trip.",
        "x-ai-required-permission": "dispatch,tripManagement",
        "x-ai-display": {
          "title": "Trip Status",
          "key": "trip_guid",
          "columns": [
            {
              "field": "status",
              "header": "Status"
            },
            {
              "field": "req_pickup_time",
              "header": "Requested Pickup"
            },
            {
              "field": "appt_time",
              "header": "Appointment"
            },
            {
              "field": "pickup_eta",
              "header": "Pickup ETA"
            },
            {
              "field": "dropoff_eta",
              "header": "Dropoff ETA"
            },
            {
              "field": "pickup_ontime_status",
              "header": "On-Time Status"
            },
            {
              "field": "driver.name",
              "header": "Driver"
            },
            {
              "field": "vehicle.vehicle_name",
              "header": "Vehicle"
            },
            {
              "field": "pickup_arrive_time",
              "header": "Arrived"
            },
            {
              "field": "pickup_perform_time",
              "header": "Picked Up"
            },
            {
              "field": "dropoff_perform_time",
              "header": "Dropped Off"
            },
            {
              "field": "cancellation_reason",
              "header": "Cancel Reason"
            }
          ]
        },
        "x-ai-inputs": [
          {
            "name": "trip_guid",
            "label": "Trip",
            "control": "select",
            "options": {
              "operation": "get-ridesfordate",
              "valueField": "trip_guid",
              "labelTemplate": "{rider.last_name}, {rider.first_name} — {pickup.pickup_time}",
              "args": "date={date};includeUnScheduled=true"
            }
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.mediroutes.com"
    }
  ],
  "components": {
    "schemas": {
      "TripStatusModel": {
        "description": "",
        "type": "object",
        "properties": {
          "trip_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "pickup_ontime_status": {
            "type": "string"
          },
          "dropoff_ontime_status": {
            "type": "string"
          },
          "req_pickup_time": {
            "format": "date-time",
            "type": "string"
          },
          "appt_time": {
            "format": "date-time",
            "type": "string"
          },
          "pickup_eta": {
            "format": "date-time",
            "type": "string"
          },
          "dropoff_eta": {
            "format": "date-time",
            "type": "string"
          },
          "driver": {
            "$ref": "#/components/schemas/DriverModel"
          },
          "vehicle": {
            "$ref": "#/components/schemas/VehicleModel"
          },
          "latitude": {
            "format": "double",
            "type": "number"
          },
          "longitude": {
            "format": "double",
            "type": "number"
          },
          "trip_charge": {
            "format": "double",
            "type": "number"
          },
          "gps_pickup_arrive_time": {
            "format": "date-time",
            "type": "string"
          },
          "gps_dropoff_arrive_time": {
            "format": "date-time",
            "type": "string"
          },
          "pickup_arrive_time": {
            "format": "date-time",
            "type": "string"
          },
          "pickup_arrive_latitude": {
            "format": "double",
            "type": "number"
          },
          "pickup_arrive_longitude": {
            "format": "double",
            "type": "number"
          },
          "pickup_perform_time": {
            "format": "date-time",
            "type": "string"
          },
          "pickup_perform_latitude": {
            "format": "double",
            "type": "number"
          },
          "pickup_perform_longitude": {
            "format": "double",
            "type": "number"
          },
          "dropoff_arrive_time": {
            "format": "date-time",
            "type": "string"
          },
          "dropoff_arrive_latitude": {
            "format": "double",
            "type": "number"
          },
          "dropoff_arrive_longitude": {
            "format": "double",
            "type": "number"
          },
          "dropoff_perform_time": {
            "format": "date-time",
            "type": "string"
          },
          "dropoff_perform_latitude": {
            "format": "double",
            "type": "number"
          },
          "dropoff_perform_longitude": {
            "format": "double",
            "type": "number"
          },
          "passenger_signature": {
            "type": "string"
          },
          "passenger_signature_url": {
            "type": "string"
          },
          "driver_signature": {
            "type": "string"
          },
          "driver_signature_url": {
            "type": "string"
          },
          "passenger_dropoff_signature": {
            "type": "string"
          },
          "passenger_dropoff_signature_url": {
            "type": "string"
          },
          "driver_dropoff_signature": {
            "type": "string"
          },
          "driver_dropoff_signature_url": {
            "type": "string"
          },
          "cancellation_reason": {
            "type": "string"
          },
          "will_call_activation_time": {
            "format": "date-time",
            "type": "string"
          },
          "card_present": {
            "type": "boolean"
          },
          "card_scanned": {
            "type": "boolean"
          },
          "card_medical_id": {
            "type": "string"
          },
          "trip_guid": {
            "format": "uuid",
            "type": "string",
            "example": "00000000-0000-0000-0000-000000000000"
          },
          "pickup_odometer": {
            "format": "int32",
            "type": "integer"
          },
          "dropoff_odometer": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "DriverModel": {
        "type": "object",
        "properties": {
          "emp_id": {
            "format": "int32",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "phone_number": {
            "type": "string"
          },
          "dln": {
            "type": "string"
          },
          "email_id": {
            "type": "string"
          },
          "picture_url": {
            "type": "string"
          }
        }
      },
      "VehicleModel": {
        "type": "object",
        "properties": {
          "vehicle_name": {
            "type": "string"
          },
          "vehicle_id": {
            "format": "int32",
            "type": "integer"
          },
          "picture_url": {
            "type": "string"
          },
          "vin": {
            "type": "string"
          },
          "license_plate_no": {
            "type": "string"
          },
          "make": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "color": {
            "type": "string"
          },
          "year": {
            "format": "int32",
            "type": "integer"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```