Clear stop arrival

DELETE

api

{version}

trips

{tripId}

stops

{stopId}

arrival

Clear stop arrival

curl --request DELETE \
  --url https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "AppointmentRequested": true,
  "AppointmentConfirmed": true,
  "ScheduleType": "<string>",
  "Id": "<string>",
  "StopType": "<string>",
  "References": [
    {
      "Name": "<string>",
      "Value": "<string>",
      "Id": "<string>",
      "ReferenceId": "<string>",
      "Type": "<string>",
      "Access": "<string>",
      "Origin": "<string>"
    }
  ],
  "$type": "<string>",
  "AppointmentDate": "2023-11-07T05:31:56Z",
  "LoadingType": "<string>",
  "Address": {
    "Street": "<string>",
    "City": "<string>",
    "State": "<string>",
    "ZipCode": "<string>"
  },
  "Coordinates": {
    "Latitude": "<string>",
    "Longitude": "<string>"
  },
  "Status": "<string>",
  "ArrivedAt": "2023-11-07T05:31:56Z",
  "DepartedAt": "2023-11-07T05:31:56Z",
  "CompanyId": "<string>",
  "CompanyNumber": "<string>",
  "CompanyName": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

Clear Stop Arrival

Clears the recorded arrival time for a specific stop within a trip. This endpoint removes the ArrivedAt timestamp from the stop, effectively marking the stop as not yet arrived. The response returns the updated stop object after the arrival timestamp has been cleared.

Endpoint

DELETE /api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival

Request 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.

Example CURL request

curl --location --request DELETE 'https://integrations.alvys.com/api/p/v1/trips/{tripId}/stops/{stopId}/arrival' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Replace:

{version} with the API version (for example 1)
{tripId} with the actual trip ID
{stopId} with the stop ID
YOUR_ACCESS_TOKEN with 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). This value will be null after clearing arrival.
DepartedAt	string (datetime)	Timestamp when the stop was 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:35:48.148Z",
  "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": null,
  "DepartedAt": "2026-03-16T12:35:48.148Z",
  "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 arrival timestamp successfully cleared.
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.

Authorizations

Authorization

string

header

required

OAuth 2.0 client-credentials access token. Obtain one from https://auth.alvys.com/oauth/token (grant_type=client_credentials, audience=https://api.alvys.com/public/), then paste it here. The playground sends it as Authorization: Bearer <token>.

Path Parameters

tripId

string

required

stopId

string

required

version

string

default:1.0

required

API version (e.g., 1.0)

Example:

"1.0"

Response

Option 1
Option 2
Option 3

AppointmentRequested

boolean

required

AppointmentConfirmed

boolean

required

ScheduleType

string

required

string

required

StopType

string

required

References

object[]

required

Show child attributes

$type

string

required

Type discriminator for polymorphic serialization

AppointmentDate

string<date-time> | null

LoadingType

string | null

Address

object | null

Show child attributes

Coordinates

object | null

Show child attributes

Status

string | null

ArrivedAt

string<date-time> | null

DepartedAt

string<date-time> | null

CompanyId

string | null

CompanyNumber

string | null

CompanyName

string | null

⌘I

Clear stop arrival

curl --request DELETE \
  --url https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://integrations.alvys.com/api/p/v{version}/trips/{tripId}/stops/{stopId}/arrival"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "AppointmentRequested": true,
  "AppointmentConfirmed": true,
  "ScheduleType": "<string>",
  "Id": "<string>",
  "StopType": "<string>",
  "References": [
    {
      "Name": "<string>",
      "Value": "<string>",
      "Id": "<string>",
      "ReferenceId": "<string>",
      "Type": "<string>",
      "Access": "<string>",
      "Origin": "<string>"
    }
  ],
  "$type": "<string>",
  "AppointmentDate": "2023-11-07T05:31:56Z",
  "LoadingType": "<string>",
  "Address": {
    "Street": "<string>",
    "City": "<string>",
    "State": "<string>",
    "ZipCode": "<string>"
  },
  "Coordinates": {
    "Latitude": "<string>",
    "Longitude": "<string>"
  },
  "Status": "<string>",
  "ArrivedAt": "2023-11-07T05:31:56Z",
  "DepartedAt": "2023-11-07T05:31:56Z",
  "CompanyId": "<string>",
  "CompanyNumber": "<string>",
  "CompanyName": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

​Clear Stop Arrival

​Endpoint

​Request Parameters

​Example CURL request

​Response Parameters

​Example Response

​Status Codes

​Rate Limits

Authorizations

Path Parameters

Response

Clear Stop Arrival

Endpoint

Request Parameters

Example CURL request

Response Parameters

Example Response

Status Codes

Rate Limits