Used to get information on devices hitting the tags that have been seen.

For more information on attributes and tags review our dedicated guide.

Returned attributes

  • tag_id int ID of tag
  • device_id int ID of the device that made the hit
  • type string platform where the tag is hit (eg. Android, iOS, web)
  • metric_id int ID of the metric attached to the hit
  • value mixed value related to tag if set; else null
  • create_time int timestamp of hit


Get all tag hits in a paginated format. For best results, we recommend setting a limit on your query. Send several requests to obtain the full list:

curl --request POST \
  --url \
  --header 'content-type: application/json' \
  --data '{
    "apptoken": "YOUR_APPTOKEN",
    "limit": 50,
    "offset": 0,
    "select": ["create_time", "tag_id", "device_id"]
Click Try It! to start a request and see the response here!