HOhologram
SIMs (Devices)

List billing usage records

Returns total data usage for each SIM summarized by the SIM's unique 30-day billing period. Records are returned per link (profile) ID by billing period, within the date range specified. Monthly Recurring Charges are billed every 30 days beginning at the time the device was activated. Data is available for the last three months.

get/usage/data/billing

Request

Query parameters

limitinteger

Maximum number of results to return (max 5000)

beforeinteger

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

afterinteger

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

linkidinteger

Filter by a specific cellular link (SIM profile) ID

linkidsstring

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

deviceidsstring

Comma-separated list of device IDs to filter by

tagidsstring

Comma-separated list of device tag IDs to filter by

timestartinteger

Unix timestamp; return records from this time onward

timeendinteger

Unix timestamp; return records up to this time

isliveboolean

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

startatstring

Return results with record ID less than this value

maxperiodsbackinteger

Maximum number of billing periods to look back

tagidinteger

Filter by device tag ID

tagnamestring

Filter by device tag name

Response

OK

successboolean

Indicates whether the request was successful.

limitinteger

Maximum number of records returned per page

sizeinteger

Number of records in this response

continuesboolean

True if more records are available

lastidstring

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

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.