In the below code, how do I replace ExcludeExceptionEvents property as its being deprecated?  and how do I use PropertySelector in this case?   private object[][] BuildDeviceStatusInfoCalls(List&lt;Device&gt; devices){	object[][] logRecordCalls = new object[devices.Count][]; 	PropertySelector prop = new PropertySelector();	prop.Fields = new List&lt;string&gt;();	prop.Fields.Add("exceptionEvents");	prop.IsIncluded = true; 	for (int i = 0; i &lt; devices.Count; i++)	{		logRecordCalls[i] = new object[4];		logRecordCalls[i][0] = "Get";		logRecordCalls[i][1] = typeof(DeviceStatusInfo);		logRecordCalls[i][2] = new		{			search = new DeviceStatusInfoSearch()			{				DeviceSearch = new DeviceSearch()				{					Id = devices[i].Id				},				ExcludeExceptionEvents = true			}		};		logRecordCalls[i][3] = typeof(List&lt;DeviceStatusInfo&gt;);	} 	return logRecordCalls;}

How do you use PropertySelector in a DeviceStatusInfo Search?

try{	API api = this.GetApi(); 	// Build DVIR	DVIRLog geotabDvirLog = new DVIRLog(); 	geotabDvirLog.LogType = DVIRLogType.PreTrip;	geotabDvirLog.Device = new Device(Id.Create("b3"));	geotabDvirLog.DateTime = DateTime.UtcNow;	geotabDvirLog.Driver = new User(Id.Create("b21")); 	Group defectGroup = new Group(Id.Create("b3FD7")); //, null, "Sunbelt Vehicle Defects List");	geotabDvirLog.DefectList = defectGroup;	geotabDvirLog.DVIRDefects = new List&lt;DVIRDefect&gt;(); 	geotabDvirLog.IsSafeToOperate = true;	geotabDvirLog.CertifiedBy = new User(Id.Create("b21"));	geotabDvirLog.CertifyDate = DateTime.Now.ToUniversalTime(); 	DVIRLog result = api.CallAsync&lt;DVIRLog&gt;("Add", typeof(DVIRLog), new	{		entity = geotabDvirLog	}).Result;}catch (Exception ex){	Console.WriteLine(ex.GetBaseException().Message);	Console.WriteLine(ex.GetBaseException().ToString());	Assert.Fail(ex.Message);} 

Problem Creating DVIRLog

The Id properties within Geotab Entities are being serialized as empty.   Below is an example of a serialized DriverChangeSearch object: {  "FromDate":"2025-11-13T00:00:00Z",   "ToDate":"2025-11-20T14:04:32.5828111Z",   "UserSearch":{"Id":{}}} Code: public string Serialize(object value)
{
	try
	{
		if (value.GetType().ToString().Contains("Geotab.Checkmate"))
		{
			JsonSerializerSettings settings = new JsonSerializerSettings()
			{
				ReferenceLoopHandling = ReferenceLoopHandling.Ignore,
				NullValueHandling = NullValueHandling.Ignore
			};
			return JsonConvert.SerializeObject(value, settings);
		}
	}
	catch (Exception ex)
	{
		return $"Serialization Failed: {ex.Message}";
	}
	return String.Empty;
}   /eeidfn

How to Serialize Geotab IDs using C# SDK?

Using Geotab SDK 11.62.237 and 11.83.265; In both, my unit tests are not working any more.   Is this due to a change to the Geotab database or upgrade on configuration change on qa_sunbelt_rentals? System.AggregateException: One or more errors occurred. (Self referencing loop detected with type 'Geotab.Checkmate.ObjectModel.GroupWithGlobalReporting'. Path 'DriverGroups[0].Parent.Children'.)   ---&gt; Newtonsoft.Json.JsonSerializationException: Self referencing loop detected with type 'Geotab.Checkmate.ObjectModel.GroupWithGlobalReporting'. Path 'DriverGroups[0].Parent.Children'.  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.CheckForCircularReference(JsonWriter writer, Object value, JsonProperty property, JsonContract contract, JsonContainerContract containerContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeList(JsonWriter writer, IEnumerable values, JsonArrayContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeObject(JsonWriter writer, Object value, JsonObjectContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeObject(JsonWriter writer, Object value, JsonObjectContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeList(JsonWriter writer, IEnumerable values, JsonArrayContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeObject(JsonWriter writer, Object value, JsonObjectContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.Serialize(JsonWriter jsonWriter, Object value, Type objectType)  at Newtonsoft.Json.JsonSerializer.SerializeInternal(JsonWriter jsonWriter, Object value, Type objectType)  at Newtonsoft.Json.JsonSerializer.Serialize(JsonWriter jsonWriter, Object value, Type objectType)  at Newtonsoft.Json.JsonConvert.SerializeObjectInternal(Object value, Type type, JsonSerializer jsonSerializer)  at Newtonsoft.Json.JsonConvert.SerializeObject(Object value, Type type, JsonSerializerSettings settings)  at Newtonsoft.Json.JsonConvert.SerializeObject(Object value)  at GeotabLibrary.Services.GeotabApiService.AddAsync[T](Entity theEntity) in C:\Projects\VDOS\GeotabProxyAPI\GeotabLibrary\Services\GeotabApiService.cs:line 350  at GeotabLibrary.Services.DriverService.CreateDriverAsync(String firstName, String lastName, Int32 clockId, Int32 pc, String timezone, Int32 companyId, Nullable`1 analysisRegion) in C:\Projects\VDOS\GeotabProxyAPI\GeotabLibrary\Services\DriverService.cs:line 199  at GeotabLibrary.Services.DriverService.CreateDriverAsync(String firstName, String lastName, Int32 clockId, Int32 pc, String timezone, Int32 companyId, Nullable`1 analysisRegion) in C:\Projects\VDOS\GeotabProxyAPI\GeotabLibrary\Services\DriverService.cs:line 224  --- End of inner exception stack trace ---  at System.Threading.Tasks.Task.ThrowIfExceptional(Boolean includeTaskCanceledExceptions)  at System.Threading.Tasks.Task`1.GetResultCore(Boolean waitCompletionNotification)  at GeotabProxy.Tests.Services.DriverServiceTests.CanCreateDriver() in C:\Projects\VDOS\GeotabProxyAPI\GeotabProxyAPICore.Tests\Services\DriverServiceTests.cs:line 207 

Need FIX for Self Referencing loop detected with type Geotab.Checkmate.ObjectModel.GroupWithGlobalReporting

These lines are executing within the ExecuteAsync() method of the BackgroundService (Microsoft.Extensions.Hosting.BackgroundService)          Console.WriteLine("Connecting to Geotab...");  // See this in the output         API api = new API("xxxx@xxxx.com", "********", null, "QA_Sunbelt_Rentals", "mypreview.com");        Task t = api.AuthenticateAsync();        t.Wait();        Console.WriteLine(api.SessionId);  // Do NOT see this in the output ex.InnerException.Message	"The SSL connection could not be established, see inner exception." ex.InnerException.InnerException.Message	"Url: 'https://mypreview.com/apiv1'; StatusCode: 'Unused'\r\n'The SSL connection could not be established, see inner exception.''"   /eeidfn

SSL error when authenticating to Geotab SDK in .NET Core 8 background service

All I want to do is get the Trailer Name from the DVIR. Why is the trailerDevice always null? This whole thing with TmpTrailerId is very confusing. Why can't we just use the "bxxx" hex ID? // Assume that these are all Trailer DVIRs
foreach (var key in dvirs.Keys)
{
    DVIRLog dvir = dvirs[key];
 
    TrailerSearch search = new TrailerSearch();
    search.Id = Id.Create(dvir.Trailer.Id.ToString());
    List&lt;Device&gt; trailerDevices = api.CallAsync&lt;List&lt;Device&gt;&gt;("Get", typeof(Device), new { search = search }).Result;
    Device trailerDevice = trailerDevices.FirstOrDefault();
 
    string trailerName = trailerDevice.Name;
} /eeidfn  

How to get trailer details from a DVIRLog in C# from the Geotab SDK?

Hi,When we make a call to Authenticate with the wrong password, after several wrong attempts, a user gets locked out. But not knowing that a user is locked out, our code makes the call and gets the error "Your account is temporarily locked due to multiple unsuccessful login attempts" and does not handle it well. We would like to loop through all users and determine, how many users are impacted by this issue, so that we can unlock the user before trying with the new password. Preferably, would like a C# example, but javascript/Runner example is fine, if its not too complicated in C#. Also, how do you unlock a user via SDK/API?   /eeidfn  

How to tell if a user is locked out via the SDK&#x2F;API and how to unlock?

How to tell if a user is locked out via the SDK/API and how to unlock?

How do I set the AutoHos value while creating a Device? The C# compiler does not like the cast, which does work in other places in the code. ((GoDevice)testDevice).AutoHos = HosOption.OFFThe above line gives an InvalidCastException  /eeidfn

How can I create a device via the MyGeotab SDK with HOS Logs turned off such that I can create and delete a device in my unit tests

Hi,How do I retrieve the system AnnotationLogs? e.g. "Operating zone set to North of 60 in Canada", "Assigned to No Vehicle" Do you have a sample in C#? /eeidfn

How to find System Annotations in MyGeotab SDK

Is there a MyGeotab API to unlock a user via API?

Under what conditions, would the API throw a DuplicateDataException? I need to do the same validation that the Geotab API does so that I don't get exceptions from backend processes. Thankseeidfn

DuplicateDataException when creating or updating users&#x2F;drivers - under what conditions would the Geotab API throw a DuplicateDataException ?

DuplicateDataException when creating or updating users/drivers - under what conditions would the Geotab API throw a DuplicateDataException ?

This code should update the Authority Address and the data access groups, but does NOT. I also have a wait time of 2 minutes before the update is called. But the create works.public void CreateAndUpdateCanadaUser()
{
    API api = new API(this.apiLogin, this.pwd, null, this.DB, this.Server);
    Task t = api.AuthenticateAsync();
    t.Wait();
    Console.WriteLine("Authenticated Successfully");
 
    int clockId = 999994;
    string timezone = "America/New_York";
    Driver driver = new Driver();
    driver = new Driver()
    {
        FirstName = "Canada" + clockId,
        LastName = "Tester" + clockId,
        EmployeeNo = clockId.ToString(),
        ActiveFrom = DateTime.Now.ToUniversalTime(),
        UserAuthenticationType = UserAuthenticationType.BasicAuthentication,
        ViewDriversOwnDataOnly = true,
        ChangePassword = false,
        TimeZoneId = timezone
    };
    driver.Name = string.Format("d{0}@sunbeltrentals.com", clockId);
    driver.Password = clockId + "!!";
    driver.HosRuleSet = HosRuleSet.CanadaCycleOne;
 
    // Add PC Groups: 494 (b2CA3) and then update to 495 (b2D13)
    List&lt;Group&gt; groups = new List&lt;Group&gt;();
    Group group = new Group();
    group.Id = Id.Create("b2CA3");
    groups.Add(group);
    driver.CompanyGroups = groups;
    driver.DriverGroups = groups;
 
    // Add Security Group: VDOS Driver (b2F87)
    Group securityGroup = new Group();
    securityGroup.Id = Id.Create("b2F87");
    List&lt;Group&gt; securityGroups = new List&lt;Group&gt;();
    securityGroups.Add(securityGroup);
    driver.SecurityGroups = securityGroups;
 
    // Set authority values
    driver.AuthorityName = configSettings.Value.CanadaAuthorityName;
    driver.AuthorityAddress = "2343 Deerfield Drive, Fort Mill, SC 29715";
 
    Id entityId = null;
    try
    {
        // Create
        entityId = api.CallAsync&lt;Id&gt;("Add", typeof(Driver), new
        {
            entity = driver
        }).Result;
        Console.WriteLine("Created Driver: " + entityId);
 
        Thread.Sleep(120000);
 
        // Update
        Driver driverU = new Driver();
        driverU.Id = entityId;
        driverU.AuthorityAddress = "1 Microsoft Way, Charlotte, NC 28200";
 
        Group newPcGroup = new Group();
        newPcGroup.Id = Id.Create("b2D13"); // PC 495
        groups.Add(newPcGroup);
        driverU.CompanyGroups = groups;
        driverU.DriverGroups = groups;
 
        Task update = api.CallAsync&lt;Driver&gt;("Set", typeof(User), new
        {
            entity = driverU
        });
        update.Wait();
        Console.WriteLine("Updated Driver: " + entityId);
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
} Thanks eeidfn

The API fails to update the user

page-user page-user-daniel-fenn-1143 template-account-profile page-status-200 theme-harmony user-guest

Company

Title

This is the full solution in C# for a multi-Call: private object[][] BuildDeviceStatusInfoCalls(List&lt;Device&gt; devices){	object[][] logRecordCalls = new object[devices.Count][]; 	PropertySelector prop = new PropertySelector	{		Fields = [nameof(DeviceStatusInfo.ExceptionEvents)],		IsIncluded = false // this will ensure the Fields specified are NOT included	}; 	for (int i = 0; i &lt; devices.Count; i++)	{		logRecordCalls[i] = new object[4];		logRecordCalls[i][0] = "Get";		logRecordCalls[i][1] = typeof(DeviceStatusInfo);		logRecordCalls[i][2] = new		{			search = new DeviceStatusInfoSearch()			{				DeviceSearch = new DeviceSearch()				{					Id = devices[i].Id				}			},			PropertySelector = prop		};		logRecordCalls[i][3] = typeof(List&lt;DeviceStatusInfo&gt;);	} 	return logRecordCalls;}

In the below code, how do I replace ExcludeExceptionEvents property as its being deprecated? and how do I use PropertySelector in this case?  private object[][] BuildDeviceStatusInfoCalls(List&lt;Device&gt; devices){	object[][] logRecordCalls = new object[devices.Count][]; <s>	PropertySelector prop = new PropertySelector();</s><s>	prop.Fields = new List&lt;string&gt;();</s><s>	prop.Fields.Add("exceptionEvents");</s><s>	prop.IsIncluded = true;</s> 	for (int i = 0; i &lt; devices.Count; i++)	{		logRecordCalls[i] = new object[4];		logRecordCalls[i][0] = "Get";		logRecordCalls[i][1] = typeof(DeviceStatusInfo);		logRecordCalls[i][2] = new		{			search = new DeviceStatusInfoSearch()			{				DeviceSearch = new DeviceSearch()				{					Id = devices[i].Id				},				ExcludeExceptionEvents = true			}		};		logRecordCalls[i][3] = typeof(List&lt;DeviceStatusInfo&gt;);	} 	return logRecordCalls;}

The below works better, IF Id is used for the return type. Id dvirId = api.CallAsync&lt;Id&gt;("Add", typeof(DVIRLog), new{ entity = geotabDvirLog}).Result;

try{	API api = this.GetApi(); 	// Build DVIR	DVIRLog geotabDvirLog = new DVIRLog(); 	geotabDvirLog.LogType = DVIRLogType.PreTrip;	geotabDvirLog.Device = new Device(Id.Create("b3"));	geotabDvirLog.DateTime = DateTime.UtcNow;	geotabDvirLog.Driver = new User(Id.Create("b21")); 	Group defectGroup = new Group(Id.Create("b3FD7")); //, null, "Sunbelt Vehicle Defects List");	geotabDvirLog.DefectList = defectGroup;	geotabDvirLog.DVIRDefects = new List&lt;DVIRDefect&gt;(); 	geotabDvirLog.IsSafeToOperate = true;	geotabDvirLog.CertifiedBy = new User(Id.Create("b21"));	geotabDvirLog.CertifyDate = DateTime.Now.ToUniversalTime(); 	DVIRLog result = api.CallAsync&lt;DVIRLog&gt;("Add", typeof(DVIRLog), new	{		entity = geotabDvirLog	}).Result;}catch (Exception ex){	Console.WriteLine(ex.GetBaseException().Message);	Console.WriteLine(ex.GetBaseException().ToString());	Assert.Fail(ex.Message);}

The Id properties within Geotab Entities are being serialized as empty.  Below is an example of a serialized DriverChangeSearch object: { "FromDate":"2025-11-13T00:00:00Z", "ToDate":"2025-11-20T14:04:32.5828111Z", "UserSearch":{"Id":{}}} Code: <code>public string Serialize(object value)
{
	try
	{
		if (value.GetType().ToString().Contains("Geotab.Checkmate"))
		{
			JsonSerializerSettings settings = new JsonSerializerSettings()
			{
				ReferenceLoopHandling = ReferenceLoopHandling.Ignore,
				NullValueHandling = NullValueHandling.Ignore
			};
			return JsonConvert.SerializeObject(value, settings);
		}
	}
	catch (Exception ex)
	{
		return $"Serialization Failed: {ex.Message}";
	}
	return String.Empty;
}</code>   /eeidfn

It was a .NET8 Core project setup issue. Problem has been solved.

Using Geotab SDK 11.62.237 and 11.83.265; In both, my unit tests are not working any more.  Is this due to a change to the Geotab database or upgrade on configuration change on qa_sunbelt_rentals? System.AggregateException: One or more errors occurred. (Self referencing loop detected with type 'Geotab.Checkmate.ObjectModel.GroupWithGlobalReporting'. Path 'DriverGroups[0].Parent.Children'.)   ---&gt; Newtonsoft.Json.JsonSerializationException: Self referencing loop detected with type 'Geotab.Checkmate.ObjectModel.GroupWithGlobalReporting'. Path 'DriverGroups[0].Parent.Children'.  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.CheckForCircularReference(JsonWriter writer, Object value, JsonProperty property, JsonContract contract, JsonContainerContract containerContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeList(JsonWriter writer, IEnumerable values, JsonArrayContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeObject(JsonWriter writer, Object value, JsonObjectContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeObject(JsonWriter writer, Object value, JsonObjectContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeList(JsonWriter writer, IEnumerable values, JsonArrayContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.SerializeObject(JsonWriter writer, Object value, JsonObjectContract contract, JsonProperty member, JsonContainerContract collectionContract, JsonProperty containerProperty)  at Newtonsoft.Json.Serialization.JsonSerializerInternalWriter.Serialize(JsonWriter jsonWriter, Object value, Type objectType)  at Newtonsoft.Json.JsonSerializer.SerializeInternal(JsonWriter jsonWriter, Object value, Type objectType)  at Newtonsoft.Json.JsonSerializer.Serialize(JsonWriter jsonWriter, Object value, Type objectType)  at Newtonsoft.Json.JsonConvert.SerializeObjectInternal(Object value, Type type, JsonSerializer jsonSerializer)  at Newtonsoft.Json.JsonConvert.SerializeObject(Object value, Type type, JsonSerializerSettings settings)  at Newtonsoft.Json.JsonConvert.SerializeObject(Object value)  at GeotabLibrary.Services.GeotabApiService.AddAsync[T](Entity theEntity) in C:\Projects\VDOS\GeotabProxyAPI\GeotabLibrary\Services\GeotabApiService.cs:line 350  at GeotabLibrary.Services.DriverService.CreateDriverAsync(String firstName, String lastName, Int32 clockId, Int32 pc, String timezone, Int32 companyId, Nullable`1 analysisRegion) in C:\Projects\VDOS\GeotabProxyAPI\GeotabLibrary\Services\DriverService.cs:line 199  at GeotabLibrary.Services.DriverService.CreateDriverAsync(String firstName, String lastName, Int32 clockId, Int32 pc, String timezone, Int32 companyId, Nullable`1 analysisRegion) in C:\Projects\VDOS\GeotabProxyAPI\GeotabLibrary\Services\DriverService.cs:line 224  --- End of inner exception stack trace ---  at System.Threading.Tasks.Task.ThrowIfExceptional(Boolean includeTaskCanceledExceptions)  at System.Threading.Tasks.Task`1.GetResultCore(Boolean waitCompletionNotification)  at GeotabProxy.Tests.Services.DriverServiceTests.CanCreateDriver() in C:\Projects\VDOS\GeotabProxyAPI\GeotabProxyAPICore.Tests\Services\DriverServiceTests.cs:line 207

Its a new .NET 8 Core Windows Service; I feel that this is related to .NET 8 Core and the Background Service. my.geotab.com is also failing.

Hi Darren,It also happens when we point to Prod (https://my45.geotab.com/apiv1) Can you please help?

These lines are executing within the ExecuteAsync() method of the BackgroundService (Microsoft.Extensions.Hosting.BackgroundService)          Console.WriteLine("Connecting to Geotab..."); // See this in the output         API api = new API("xxxx@xxxx.com", "********", null, "QA_Sunbelt_Rentals", "mypreview.com");        Task t = api.AuthenticateAsync();        t.Wait();        Console.WriteLine(api.SessionId); // Do NOT see this in the output ex.InnerException.Message	"The SSL connection could not be established, see inner exception." ex.InnerException.InnerException.Message	"Url: 'https://mypreview.com/apiv1'; StatusCode: 'Unused'\r\n'The SSL connection could not be established, see inner exception.''"   /eeidfn

Recent Activity

How do you use PropertySelector in a DeviceStatusInfo Search?

Problem Creating DVIRLog

How to Serialize Geotab IDs using C# SDK?