Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

An unofficial Python client for the MyGeotab API

Project Description

Build Status Documentation Status Code Coverage PyPI Version Python Versions License

An Apache2 Licensed, unofficial Python client for the MyGeotab SDK.

Also bundled is the “myg” command line tool, which is a sandboxed console for quickly querying and operating on MyGeotab data.


  • Automatic serializing and de-serializing of JSON results
  • Clean, Pythonic API for querying data
  • Cross-platform and compatible with Python 2.7.9+, 3.4+, and pypy 4+


>>> import mygeotab
>>> api = mygeotab.API(username='', password='mypass', database='DemoDB')
>>> api.authenticate()
>>> api.get('Device', name='%Test Dev%')
[{'maxSecondsBetweenLogs': 200.0,
  'activeTo': '2050-01-01',
  'minAccidentSpeed': 3.0,
  'ignoreDownloadsUntil': '1986-01-01',
  'name': 'Test Device',
  'idleMinutes': 3.0,


To install the MyGeotab library and command line tool:

$ pip install mygeotab

or for the bleeding-edge version:

$ pip install git+


Read the docs at


0.6.2 (2017-07-04)

Bug Fixes

  • Revert the change to stop compilation in setup.cfg.

0.6.1 (2017-07-03)

Bug Fixes

  • Don’t compile to prevent issues when installing via on Python 2.7.

0.6.0 (2017-06-29)


  • Configurable timeouts when making calls.
  • Removed verify parameter from API objects as SSL is required when calling a MyGeotab server.
  • Removed run command from the CLI.
  • Removed deprecated and API.search_async methods.
  • Refactored for async API. The async/awaitable methods are now automatically a part of the API object if using Python 3.5 or higher
  • Code linting and cleanup

0.5.4 (2017-06-05)

Bug Fixes

  • Ensure all dates are timezone aware and are always UTC-localized.

0.5.3 (2017-05-30)

Bug Fixes

  • Fixed intermittent timeout errors due to upstream changes in the ‘requests’ module

0.5.2 (2017-02-02)

Bug Fixes

  • Switched back to using abstract dependencies in (recommended by this guide)

0.5.1 (2017-01-04)

Bug Fixes

  • Fix for search parameter not being properly handled in ‘get()’ call

0.5 (2017-01-02)


  • Deprecated the ‘search()’ and ‘search_async()’ functions. Replaced by folding the previous functionality into ‘run()’.
  • Removed ‘tzlocal’ dependency. Always deal with dates in UTC by default.
  • Prefer functions instead of making static methods in classes.
  • Added helper to run async calls and collect their results
  • Add ability to quickly run simple python scripts from the ‘myg’ console with no need for any authentication handling. Similar to ‘console’, but for running scripts rather than creating an interactive console.

0.4.4 (2016-07-10)


  • Added the ability to make unauthenticated calls (like “GetVersion”) with the static “API.server_call” method
  • Added asyncio-based API query methods (Python 3.5+ only) into the “ext” package
  • Moved the datafeed to the “ext” package, as well

Bug Fixes

  • MyGeotab never returns 3 digits of milliseconds, so follow that format as well to allow the use of “dates.format_iso_datetime” to create MyGeotab URLs

0.4.2 (2016-03-17)

Bug Fixes

  • Use a custom User-Agent when making requests

0.4 (2016-02-25)


  • Extension for facilitating use of the MyGeotab Data Feed
  • Allow Pythonic underscore-separated parameters mapped to camelcase ones
  • Force the use of TLS 1.2 for upcoming strict security requirements in MyGeotab (Note that TLS 1.2 is only supported in Python 2.7.9+ and 3.4+)

Bug Fixes

  • Fixed issue with CLI console startup
  • Use the system’s default user location for config files

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mygeotab-0.6.2-py2.py3-none-any.whl (20.0 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Jul 5, 2017
mygeotab-0.6.2.tar.gz (83.3 kB) Copy SHA256 hash SHA256 Source None Jul 5, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page