Skip to main content
GET
/
usage
/
data
/
billing
List billing usage records
curl --request GET \
  --url https://dashboard.hologram.io/api/1/usage/data/billing \
  --header 'Authorization: Basic <encoded-value>'
{
  "success": true,
  "limit": 123,
  "size": 123,
  "continues": true,
  "lastid": "<string>",
  "links": {
    "path": "<string>",
    "base": "<string>",
    "next": "<string>"
  },
  "data": [
    {
      "linkid": 123,
      "cur_period_end": "<string>",
      "periods_back": "<string>",
      "record_id": "<string>",
      "bytes": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

HTTP Basic authentication using API keys. Set the username to apikey and the password to your API key. You can find your API key on the Hologram Dashboard under Account Settings.

Query Parameters

​
limit
integer
default:100

Maximum number of results to return (max 5000)

Required range: x <= 5000
​
before
integer

Return records with ID less than this value (cursor-based pagination)

​
after
integer

Return records with ID greater than this value (cursor-based pagination)

​
linkid
integer

Filter by a specific cellular link (SIM profile) ID

​
linkids
string

Comma-separated list of link (SIM profile) IDs to filter by

​
deviceids
string

Comma-separated list of device IDs to filter by

​
tagids
string

Comma-separated list of device tag IDs to filter by

​
timestart
integer

Unix timestamp; return records from this time onward

​
timeend
integer

Unix timestamp; return records up to this time

​
islive
boolean

When true, include only live (non-paused) devices

​
startat
string

Return results with record ID less than this value

​
maxperiodsback
integer

Maximum number of billing periods to look back

​
tagid
integer

Filter by device tag ID

​
tagname
string

Filter by device tag name

Response

OK

​
success
boolean

Indicates whether the request was successful.

Example:

true

​
limit
integer

Maximum number of records returned per page

​
size
integer

Number of records in this response

​
continues
boolean

True if more records are available

​
lastid
string

record_id of the last record returned; pass as startat to fetch the next page

​
links
object
​
data
object[]