Skip to main content
GET
/
{instance}
/
heartbeats
Heartbeats
curl --request GET \
  --url https://app.hypersender.com/api/sms/v1/{instance}/heartbeats \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "9e05f90c-affd-4e8f-967d-811a19ec575f",
      "phone_id": "9defcf1e-552c-4bef-a843-872edec576ef",
      "battery_level": 96,
      "is_charging": false,
      "local_timestamp": "2025-01-21 18:41:42",
      "app_version": null,
      "created_at": "2025-01-21 18:41:43",
      "updated_at": "2025-01-21 18:41:43"
    }
  ],
  "links": {
    "first": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=1",
    "last": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=72",
    "prev": null,
    "next": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 72,
    "links": [
      {
        "url": null,
        "label": "&laquo; Previous",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=2",
        "label": "2",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=3",
        "label": "3",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=4",
        "label": "4",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=5",
        "label": "5",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=6",
        "label": "6",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=7",
        "label": "7",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=8",
        "label": "8",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=9",
        "label": "9",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=10",
        "label": "10",
        "active": false
      },
      {
        "url": null,
        "label": "...",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=71",
        "label": "71",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=72",
        "label": "72",
        "active": false
      },
      {
        "url": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats?per_page=1&page=2",
        "label": "Next &raquo;",
        "active": false
      }
    ],
    "path": "https://beta.hypersender.com/api/sms/v1/9defcf1e-552c-4bef-a843-872edec576ef/heartbeats",
    "per_page": 1,
    "to": 1,
    "total": 72
  }
}
Index heartbeats of the phone sorted by last heartbeat. You can filter by various attributes, and this endpoint is paginated.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
instance
string
required

Instance UUID copied from hypersender dashboard

Example:

"{{ instance_id }}"

Query Parameters

​
per_page
string

number of messages per page, max: 50

​
filter[app_version]
string

filter by the android application version that was installed on your phone

​
filter[battery_level]
integer

filter by percentage of the battery

​
filter[is_charging]
boolean

filter by wither the phone was charging or not

​
filter[local_timestamp]
string

get heartbeats by the local time of the phone

​
filter[created_at]
string

filter by when the heartbeat was created on the system.

​
sort
string

default: -created_at, you can sort by any date: 'created_at', 'local_timestamp'

​
include
string

include the phone object with the heartbeat, possible values: phone

​
page
string

when paginating use this property to navigate through pages, example: page=2, page=1 and so on..

Response

Successful response

​
data
object[]
​
links
object
​
meta
object
⌘I