Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hologram.io/llms.txt

Use this file to discover all available pages before exploring further.

Caution: IMEIs can change if a SIM moves between devices. Not every network provides IMEI information for every session.

​
How do I use the REST API to check usage by IMEI?

1

Get the device ID from IMEI

cURL
curl --request GET \
  'https://dashboard.hologram.io/api/1/devices/?orgid=YOUR_ORG_ID&imei=YOUR_IMEI' \
  -u apikey:YOUR_HOLOGRAM_API_KEY
2

Fetch usage (optionally filter by epoch start/end)

cURL
curl --request GET \
  'https://dashboard.hologram.io/api/1/usage/data?deviceid=YOUR_DEVICE_ID&timestart=YOUR_EPOCH_START&timeend=YOUR_EPOCH_END' \
  -u apikey:YOUR_HOLOGRAM_API_KEY

​
Python example

import requests
from requests.auth import HTTPBasicAuth
import json
import datetime

usr = 'apikey'
pwd = 'YOUR_HOLOGRAM_API_KEY'
orgid = 'YOUR_ORG_ID'
imei = 'YOUR_IMEI'

dev_res = requests.get(
  f'https://dashboard.hologram.io/api/1/devices/?orgid={orgid}&imei={imei}',
  auth=HTTPBasicAuth(usr, pwd)
)
device_id = dev_res.json()['data'][0]['id']

start = int(datetime.datetime(2021, 9, 28).timestamp())
end = int(datetime.datetime(2021, 10, 5).timestamp())

usage_res = requests.get(
  f'https://dashboard.hologram.io/api/1/usage/data?deviceid={device_id}&orgid={orgid}&timestart={start}&timeend={end}',
  auth=HTTPBasicAuth(usr, pwd)
)
print(json.dumps(usage_res.json(), indent=2))

Check data usage in your dashboard

Search for a SIM by IMEI then check data usage in your dashboard.