SELECT YOUR REGION AND LANGUAGE

UNITED STATES
English
LATIN AMERICA
Español
Português
AUSTRALIA &
NEW ZEALAND

English
JAPAN
Japanese
ASIA PACIFIC
English

CLOSE
SPOT

SPOT Trace

SATELLITE TRACKING DEVICE

Get Help Get Help
Documents Documents
Firmware Firmware
Videos Videos

Latest Firmware

Release Date
18/01/2023
Firmware Version
2.0.2
Firmware Updater Version
2.10.1
Update Firmware >>

SPOT Trace Support

General

Public API and XML Feed

SPOT API Support: [email protected]
 

API Access:
 

Due to abuse, API calls are now limited. If you receive a 429 error message, you need to slow down your requests.

Be considerate when making API calls, this service is provided free of charge, please do not abuse it. Repeatedly accessing the same feed in very short time periods will result in your IP being blocked or your feed disabled.

Please allow at least 2.5 minutes between calls of the same feed and if you are pulling multiple feeds have your application sleep at least 2 seconds between feed requests.


-- The API will only return data from the point in time the feed was created, up to a maximum of 7 days.  Example: If you create a brand new feed for a device today, you will not be able to pull data  from previous days on this new feed. --

 

The SPOT XML Feed is built upon an XML data stream that is enabled when a new xml feed is created.
The first step is to create an XML Feed in your account. 

 

Step 1

Step 1
 

 


 

Step 2

Step 2
 
 

Step 3

Step 3
 
 

Step 4

Step 4

 
 

Step 5

Step 5

 
 

Step 6

Step 6
Copy this feed ID.  You will need to add it to the API URL so that your URL looks like this: 

https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/0onlLopfoM4bG5jXvWRE8H0Obd0oMxMBq/message.xml

If you need to obtain your feed ID again, click View Details from the XML Feed tab and it will display your feed ID for you.
 
 
Available API usage calls:
Adding .xml before any further query string parameters will return XML and .json will return JSON.
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml

Last 50 Messages in XML format:
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml

Paging in increments of 50 in XML format (Note: No ?start= results in newest 50 by default):
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml?start=51
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml?start=101

Last 50 Messages in JSON format (both are the same request):
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.json

Last 50 Messages with password (you should be able to add ?feedPassword to any of the feed requests):
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml?feedPassword=123456

Start/End Date - 7 days worth of data max restriction applies, regardless of what date you put in there:
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml?startDate=2012-07-03T00:00:00-0000&endDate=2012-08-02T00:00:00-0000
(Offset functionality is currently not implemented, using -0000 is the only available offset)
 
Latest - This one will show you the latest message for each device on the shared page, and only the latest message:
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/latest.xml

 
The following message types are available via the current feed:
  • OK
  • TRACK
  • EXTREME-TRACK
  • UNLIMITED-TRACK
  • NEWMOVEMENT
  • HELP
  • HELP-CANCEL
  • CUSTOM
  • POI
  • STOP
The XML returned via an api.findmespot.com feed will look like this:
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <feedMessageResponse>
    <count>10</count>
    <feed>
      <id>03XHH0sPyTiYUsYD2TVJ4q7CzEH89HBhG</id>
      <name>OneAtATime</name>
      <description>OneAtATime</description>
      <status>ACTIVE</status>
      <usage>0</usage>
      <daysRange>7</daysRange>
      <detailedMessageShown>true</detailedMessageShown>
    </feed>
    <totalCount>10</totalCount>
    <activityCount>0</activityCount>
    <messages>
      <message clientUnixTime="0">
        <id>4937065</id>
        <messengerId>0-8356068</messengerId>
        <messengerName>Spot2</messengerName>
        <unixTime>1364909292</unixTime>
        <messageType>HELP-CANCEL</messageType>
        <latitude>-99999.0</latitude>
        <longitude>-99999.0</longitude>
        <modelId>SPOT2</modelId>
        <showCustomMsg>Y</showCustomMsg>
        <dateTime>2013-04-02T06:28:12-0700</dateTime>
        <hidden>0</hidden>
        <messageContent>The help message has been cancelled</messageContent>
      </message>
      <message clientUnixTime="0">
        <id>4937064</id>
        <messengerId>0-8356068</messengerId>
        <messengerName>Spot2</messengerName>
        <unixTime>1364909283</unixTime>
        <messageType>HELP</messageType>
        <latitude>45.42249</latitude>
        <longitude>-111.68832</longitude>
        <modelId>SPOT2</modelId>
        <showCustomMsg>Y</showCustomMsg>
        <dateTime>2013-04-02T06:28:03-0700</dateTime>
        <hidden>0</hidden>
        <messageContent>This is the default HELP message. Please update.</messageContent>
      </message>
      <message clientUnixTime="0">
        <id>4937060</id>
        <messengerId>0-8356068</messengerId>
        <messengerName>Spot2</messengerName>
        <unixTime>1364908774</unixTime>
        <messageType>CUSTOM</messageType>
        <latitude>45.42249</latitude>
        <longitude>-111.68832</longitude>
        <modelId>SPOT2</modelId>
        <showCustomMsg>Y</showCustomMsg>
        <dateTime>2013-04-02T06:19:34-0700</dateTime>
        <hidden>0</hidden>
        <messageContent>This is a custom message</messageContent>
      </message>
      <message clientUnixTime="0">
        <id>4937059</id>
        <messengerId>0-8356068</messengerId>
        <messengerName>Spot2</messengerName>
        <unixTime>1364908765</unixTime>
        <messageType>OK</messageType>
        <latitude>45.42249</latitude>
        <longitude>-111.68832</longitude>
        <modelId>SPOT2</modelId>
        <showCustomMsg>Y</showCustomMsg>
        <dateTime>2013-04-02T06:19:25-0700</dateTime>
        <hidden>0</hidden>
        <messageContent>This is the default SPOT Check-in/OK message. Please update.</messageContent>
      </message>
      <message clientUnixTime="0">
        <id>4937057</id>
        <messengerId>0-8356068</messengerId>
        <messengerName>Spot2</messengerName>
        <unixTime>1364908512</unixTime>
        <messageType>TRACK</messageType>
        <latitude>45.42249</latitude>
        <longitude>-111.68832</longitude>
        <modelId>SPOT2</modelId>
        <showCustomMsg>Y</showCustomMsg>
        <dateTime>2013-04-02T06:15:12-0700</dateTime>
        <hidden>0</hidden>
      </message>
    </messages>
  </feedMessageResponse>
</response>

The XML document will contain 0 or more messages. Only the messengers and message types enabled by the customer will be available in this data stream.

Need more help?


CONTACT US

CALL

Phone Support in English, French, Portuguese and Spanish

Support in English is provided from Monday 6 a.m. to Friday 11 p.m. (UK time), including public holidays.

Support in French and Spanish provided weekdays from 2p.m. to 11:00 p.m. (UK time), including public holidays.

Please have your PIN ready when calling.

PIN confirmation is not supported via voice. Please enter your PIN on your phone dial-pad.

Your PIN, personal identification number, can be found on the Account Summary when you log into your My Account.

UK
+44 808 189 6244       +44 203 966 6746

France
+33 800 91 16 33         +33 184 88 3811

Ireland
+353 94 950 5096

Italy
+39 800 743048

Netherlands 
+31 800 0900114

Norway
+47 800 25 172

Sweden
+46 20 88 15 59

Switzerland
+41 800 001 516

Spain
+34 900 83 8735

Portugal (toll-free/chamada gratuita)
+351 800 181 029

For all other areas call
+353 94 950 5096