put
https://integrations.alvys.com/api/p/v/trips//stops//departure
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Record Stop Departure
Records the departure time for a specific stop within a trip.
This endpoint marks the stop as departed and updates the stop's DepartedAt timestamp.
The DepartedAt field is required and must contain a valid ISO-8601 UTC datetime.
The response returns the updated stop object.
Endpoint
PUT /api/p/v{version}/trips/{tripId}/stops/{stopId}/departureRequest Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| version | string | Yes | API version (e.g. 1.0). |
| tripId | string | Yes | Unique identifier of the trip. |
| stopId | string | Yes | Unique identifier of the stop. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| DepartedAt | string (datetime) | Yes | Departure timestamp in ISO-8601 UTC format (e.g., 2026-03-16T12:44:51.437Z). |
Example Request Body
{
"DepartedAt": "2026-03-16T12:44:51.437Z"
}Example CURL request
curl --location --request PUT 'https://integrations.alvys.com/api/p/v1/trips/{tripId}/stops/{stopId}/departure' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"DepartedAt": "2026-03-16T12:44:51.437Z"
}'Replace:
{version}with the API version (for example1){tripId}with the actual trip ID{stopId}with the stop IDYOUR_ACCESS_TOKENwith your Bearer token
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Unique identifier of the stop. |
| address.street | string | Street address of the stop location. |
| address.city | string | City of the stop location. |
| address.state | string | State of the stop location. |
| address.zipCode | string | ZIP code of the stop location. |
| appointmentConfirmed | boolean | Indicates whether the appointment has been confirmed. |
| appointmentDate | string (datetime) | Appointment date and time for the stop. |
| appointmentRequested | boolean | Indicates whether an appointment has been requested. |
| arrivedAt | string (datetime) | Timestamp when the stop was marked as arrived (UTC). |
| departedAt | string (datetime) | Timestamp when the stop was marked as departed (UTC). |
| scheduleType | string | Schedule type (APPT or FCFS). |
| loadingType | string | Loading type (Live, Drop, Hook, etc.). |
| stopType | string | Type of stop (Pickup, Delivery, Waypoint). |
| status | string | Operational status of the stop. |
| coordinates.latitude | string | Latitude of the stop location. |
| coordinates.longitude | string | Longitude of the stop location. |
| references[] | array | List of references associated with the stop. |
| references[].id | string | Reference identifier. |
| references[].referenceId | string | External reference identifier. |
| references[].name | string | Name of the reference field. |
| references[].value | string | Value of the reference. |
| references[].type | string | Type of reference. |
| references[].access | string | Access level (Public, Internal). |
| references[].origin | string | Origin of the reference. |
| companyId | string | Identifier of the company associated with the stop. |
| companyNumber | string | Company registration or identification number. |
| companyName | string | Company name associated with the stop. |
Example Response
{
"AppointmentRequested": true,
"AppointmentConfirmed": true,
"AppointmentDate": "2026-03-16T12:44:51.437Z",
"ScheduleType": "string",
"LoadingType": "string",
"Id": "string",
"Address": {
"Street": "string",
"City": "string",
"State": "string",
"ZipCode": "string"
},
"Coordinates": {
"Latitude": "string",
"Longitude": "string"
},
"Status": "string",
"StopType": "string",
"ArrivedAt": "2026-03-16T12:44:51.437Z",
"DepartedAt": "2026-03-16T12:44:51.437Z",
"References": [
{
"Id": "string",
"ReferenceId": "string",
"Name": "string",
"Value": "string",
"Type": "string",
"Access": "string",
"Origin": "string"
}
],
"CompanyId": "string",
"CompanyNumber": "string",
"CompanyName": "string"
}Status Codes
| Status Code | Description |
|---|---|
| 200 OK | Stop departure successfully recorded. |
| 400 Bad Request | Invalid request body or timestamp format. |
| 404 Not Found | Trip or stop could not be found. |
Rate Limits
All endpoints are subject to API rate limits to ensure service stability and protect against traffic spikes.
Refer to the Rate Limits documentation for more information.