Introduction
A device share represents the sharing of streaming data from a device into multiple databases. A database which is the primary device subscriber may share the data with one or many other databases.
Important Legal and Cost Considerations:
  • Legal and cost implications: Data sharing carries legal and potential cost implications for both parties
  • Authorization required: All participants must be authorized to act on behalf of their respective organizations to establish the integration for the purposes of sharing data to or receiving data from other databases
  • Fees may apply: Consult your reseller or account manager before proceeding
  • Termination rights: Either party may terminate the share at any time by removing the DeviceShare entity
  • Acknowledgment: Programmatic invocation of the Add or Set API methods constitutes explicit acknowledgment of these terms on behalf of the caller's organization and is recorded in the system audit log
**Legal Disclaimer - Creating a Data Share:**
By enabling the sharing of this data, I confirm I am authorized to share this device data on behalf of my organization. Fees may apply. This share can be terminated anytime.
**Legal Disclaimer - Accepting an Incoming Data Share:**
Another Geotab user wants to share device data with your database. If you accept:
  • Your database will get access to telematics data for the shared device(s).
  • Fees may apply, depending on your agreement. Check with your reseller or account manager before you accept.
  • Either party can stop the share at any time
  • By accepting, you confirm you're authorized to receive this data for your organization.
**Consent and Audit Logging:**
Any programmatic activation of data sharing endpoints (Add, Set) acts as an execution of implied consent and will be tracked automatically via the system transactional audit log.
Properties

acceptedDateTime

The date that the DeviceShare was accepted.

dateTime

The date time of when the DeviceShare was created.

expirationDateTime

When the DeviceShare is set to expire.

id

The unique identifier for the specific Entity object in the Geotab system. See Id.

myAdminId

The Int32 id that MyAdmin associates with this DeviceShare.

name

The name of this entity which identifies it and is used when displaying this entity.

options

The DeviceShareOptions of this DeviceShare.

serialNumber

The String serial number of the device associated with this DeviceShare.

shareStatus

The DeviceShareStatus of this DeviceShare.

shareType

The DeviceShareType of this DeviceShare.

sourceDatabaseName

The name of the source database for this device share. This is the database that owns the device and is allowing the sharing to occur.

targetDatabaseName

The name of the target database for this device share. This is the database that the device's data is being shared to, and does not own the device.

terminatedDateTime

The date that the DeviceShare was terminated.

updatedDateTime

The date time of when the DeviceShare status was updated. This is when the share request was accepted/rejected by a target-database user or cancelled by a source-database user.

version

The version of the entity.
Rate limits
MethodDescriptionLimitPeriodStatus
GetLimit of 800 Get requests per 1m.8001mInactive
SetLimit of 250 Set requests per 1m.2501mNot specified
AddLimit of 250 Add requests per 1m.2501mNot specified
GetCountOfLimit of 250 GetCountOf requests per 1m.2501mNot specified
GetFeedLimit of 250 GetFeed requests per 1m.2501mActive
RemoveLimit of 250 Remove requests per 1m.2501mNot specified
Timeout Limit
MethodDescriptionLimitStatus
GetFeed180Active

Loading API Runner...