Skip to main content
GET
/
usage
/
sms
List outbound SMS usage
curl --request GET \
  --url https://dashboard.hologram.io/api/1/usage/sms \
  --header 'Authorization: Basic <encoded-value>'
{
  "success": true,
  "limit": 5,
  "size": 2,
  "continues": false,
  "data": [
    {
      "id": 123456,
      "deviceid": 4020513,
      "orgid": 98268,
      "linkid": 5422976,
      "timestamp": "2025-09-18 14:30:00",
      "body": "Test SMS",
      "destination": "+15551234567",
      "status": "delivered",
      "cost": "0.05"
    }
  ]
}

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

​
orgid
integer
Example:

144

​
orgids
number[]
​
startafter
integer
Example:

102544

​
linkid
number
​
linkids
number[]
​
tagid
number
​
tagids
number[]
​
timestart
integer
Example:

1642744800

​
timeend
number
​
tagname
string
​
islive
boolean
​
limit
integer

Maximum number of items to return in a single request. For endpoints that support pagination, use this with corresponding /pages endpoints to manage large result sets.

Example:

50

Response

200 - application/json

List of device-originated SMS messages

​
success
boolean
​
limit
integer
​
size
integer
​
continues
boolean
​
data
object[]