View Subscriptions report

View Subscriptions report

GET https://api.ocamba.com/v1/hood/reports/subscriptions
The Subscriptions report provides a snapshot-based view of users data.

Tip

The Subscriptions report is recommended when:

  • You do not need the absolute most up-to-date user information (snapshot delay is usually a few hours).
  • You prefer stable, pre-aggregated data with predictable performance.
  • You want filtering behavior that applies consistently to all users.
Note
Each row in the Subscriptions report corresponds to a single unique user and includes a standardized set of fields derived from all relevant user events.

Rate limits:

  • Burst: 10/s
  • Steady: 150/m

Query parameters

parameters

Response schemas

curl -X GET \
 "https://api.ocamba.com/v1/hood/reports/subscriptions" \
  -H "Authorization: Bearer {TOKEN}"
const url = 'https://api.ocamba.com/v1/hood/reports/subscriptions';
const options = {
  method: 'GET',
  headers: {
    Authorization: `Bearer {TOKEN}`
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
$ch = curl_init("https://api.ocamba.com/v1/hood/reports/subscriptions");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

200 OK

[
  {
    "ad_last_clicked": "2024-03-31T16:48:10Z",
    "ad_last_impression": "2024-03-08T17:02:29Z",
    "ad_served": 79,
    "ad_impressions": 74,
    "ad_clicks": 2,
    "timezone": "Europe/Vienna"
  }
]

400 Bad Request

{
  "code": 400,
  "title": "Bad request.",
  "message": "The request is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

500 Internal Server Error

{
  "code": 500,
  "title": "Internal server error.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}
Responses