mutation · Module: Routes
Arguments
| Argument | Type | Description |
|---|---|---|
id | ID! | The object’s ID. |
stopId | ID! | The stop id. |
input | StopOutcomeInput | The fields for this operation. |
StopOutcomeInput fields
| Field | Type |
|---|---|
at | String |
position | StopOutcomeInputPositionInput |
results | [StopOutcomeInputResultsItemInput!] |
Returns
RouteRun!
| Field | Type |
|---|---|
id | String! |
object | RouteRunObject! |
livemode | Boolean! |
created | Int! |
updated | Int |
route | String |
date | String! |
status | RouteRunStatus! |
scheduled_start | String |
started_at | Int |
completed_at | Int |
vehicle | Vehicle |
driver | Driver |
stops | [RouteRunStopsItem!]! |
legs | [RouteRunLegsItem!] |
shipment_count | Int |
user_metadata | UserMetadata |
carrier_metadata | CarrierMetadata |
system_metadata | SystemMetadata |
Errors
Errors are returned inerrors[], with the REST error object in extensions (type, code, param, request_id), using the codes in Conventions §9.
mutation ArriveRouteRunStop($id: ID!, $stopId: ID!, $input: StopOutcomeInput!) {
arriveRouteRunStop(id: $id, stopId: $stopId, input: $input) {
id
object
status
livemode
created
updated
route
date
scheduled_start
started_at
completed_at
vehicle {
id
object
name
type
status
livemode
}
driver {
id
object
status
livemode
created
updated
}
stops {
id
status
facility
contact {
name
company
email
phone
}
reason
scheduled_arrival
}
legs {
id
status
departed_at
arrived_at
delay_minutes
load {
handling_units
}
}
shipment_count
}
}
{
"id": "run_1a2B3c",
"stopId": "example_id",
"input": {
"at": "example",
"position": {
"latitude": 51.5074,
"longitude": -0.1278
},
"results": [
{
"shipment": "shp_1Q2w3E4r5T6y",
"outcome": "delivered",
"reason": "example",
"proof_of_delivery": {
"signed_by": "example",
"signature_file": "example",
"photo_files": [
"example"
],
"delivered_to": "example"
}
}
]
}
}
{
"data": {
"arriveRouteRunStop": {
"id": "run_1a2B3c",
"object": "route_run",
"status": "planned",
"livemode": true,
"created": 1791302400,
"updated": 1791302400,
"route": "rte_lax_lhr_daily",
"date": "2026-10-07",
"scheduled_start": "example",
"started_at": 1791302400,
"completed_at": 1791302400,
"vehicle": {
"id": "veh_1a2B3c",
"object": "vehicle",
"name": "Example",
"type": "car",
"status": "active",
"livemode": true
},
"driver": {
"id": "drv_1a2B3c",
"object": "driver",
"status": "active",
"livemode": true,
"created": 1791302400,
"updated": 1791302400
},
"stops": [
{
"id": "obj_1a2B3c",
"status": "pending",
"facility": "fac_lon_hub",
"contact": {
"name": "Example",
"company": "example",
"email": "ops@example.com",
"phone": "+447700900123"
},
"reason": "example",
"scheduled_arrival": "example"
}
],
"legs": [
{
"id": "obj_1a2B3c",
"status": "pending",
"departed_at": 1791302400,
"arrived_at": 1791302400,
"delay_minutes": 2,
"load": {
"handling_units": 2
}
}
],
"shipment_count": 2
}
}
}