Asset Tracking API

This document describes the Meridian APIs related to Asset Tracking.

The Asset-beacons Endpoint

The asset-beacons endpoint can be used to get information about tags that have been deployed to a location or to upload an image to a Tag.


This endpoint will return Aruba Tag information without current position.

GET Tags

You can use the asset-beacons endpoint to get the location of a specific Tag.

Aruba Tags aren't tracked in real-time. The API isn't intended for this purpose.

   /api/locations/{location ID}/asset-beacons/{MAC address}

Aruba Tags chirp once every second, but new locations are only updated every 8 seconds. This is subject to change.

Upload Images

You can use the asset-beacons endpoint to upload, replace, or delete an image for a specific Aruba Tag.

    /api/locations/{location ID}/asset-beacons/{MAC}/image

Use PUT to upload or replace an image. Use DELETE to remove an image. Use GET to grab a Tag's image.


Aruba Tag labels are collected in the tag_ids field.

The tag_ids field is an array of unique label identifiers. The tags field contains ids and label names.

Check Tags Accuracy

In order to check the accuracy of an Aruba Tag, you can use control_x and control_y to note the spot on a map where a Tag actually is. You can then compare this to where Meridian has located the Tag.

control_x and control_y have no values until defined by the user.

Internal Tags URLs

You can subscribe to Aruba Tag events, or asset updates, by MAC, Tag label, or map ID. You can have multiple Tag subscriptions on one socket.

The following URLs permit you to get information on a Tag regardless of your account access. Do not share with customers.

Create a Tag

Use POST to create a new Tag.

The required values are name and mac. The external_id value is optional.

External ID is used to relate a Tag to a non-Meridian resource, such as an inventory database.

    /api/locations/{location ID}/asset-beacons

Delete a Tag

Use DELETE to remove a Tag from your location.

    /api/locations/{location ID}/asset_beacons/{MAC}

Websocket URLs

The following URLs are in beta and subject to change.

Here's an example of getting a specific Tag by its MAC address:{MAC}

This is the current websocket API URL:

Tag Tracker API

The Tag Tracker API is intended for app developers wanting to build apps on the Aruba Tags asset tracking infrastructure.

For a JavaScript example, please go to the Tag Tracking Example.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.