Skip to main content
GET
/
v1
/
object
/
{object_type}
/
List Objects by type
curl --request GET \
  --url https://hub.suprsend.com/v1/object/{object_type}/ \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "count": 1,
    "limit": 10,
    "has_prev": false,
    "before": null,
    "has_next": false,
    "after": null
  },
  "results": [
    {
      "object_type": "teams",
      "id": "devs",
      "subscriptions_count": 1,
      "properties": {},
      "created_at": "2024-11-04T09:30:05.141405+00:00",
      "updated_at": "2025-04-06T11:00:24.257046+00:00",
      "$inbox": [
        {
          "value": "mwjNxXS-z5IvY6VwyXweG0mqc14WL-z9ctBlJ-4wx60",
          "id_provider": "suprsend",
          "status": "active",
          "perma_status": "active"
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.

Path Parameters

​
object_type
string
required

Used to group similar objects together. Give plural namespace like teams, organizations, and roles.

Response

200 - application/json

200 - OK

​
meta
object
​
results
object[]

List of objects belonging to given object type. Response JSON is similar to object upsert API.