Report tracking health
What measuring the project's ads relies on, from the last seven days: hosts with web page views, the iOS and Android SDKs and versions that reported events, and how many app users were first identified or touched on the web.
Takes no options.
Guide: Analytics overview
A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.
In: header
Path parameters
The project's id, proj_.... A secret key works only in the project it belongs to.
Examples
curl -X POST "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/analytics/reports/tracking-health" \ -H "Authorization: Bearer vh_sk_..."{ "projectId": "proj_tz4a98xxat96iws9zmbrgj3a", "start": "2026-03-07T09:00:00.000Z", "end": "2026-03-14T09:00:00.000Z", "web": { "hosts": [ { "host": "example.app", "pageviews": 18420, "lastPageviewAt": "2026-03-14T08:59:12.000Z" } ], "sdkVersions": [ { "sdk": "web", "version": "1.4.0", "events": 52310, "lastEventAt": "2026-03-14T08:59:12.000Z" } ], "lastEventAt": "2026-03-14T08:59:12.000Z" }, "apps": [ { "platform": "ios", "events": 412880, "lastEventAt": "2026-03-14T08:59:58.000Z", "sdkVersions": [ { "sdk": "ios", "version": "1.4.0", "events": 398102, "lastEventAt": "2026-03-14T08:59:58.000Z" }, { "sdk": "ios", "version": "1.3.2", "events": 14778, "lastEventAt": "2026-03-14T08:41:07.000Z" } ] }, { "platform": "android", "events": 96214, "lastEventAt": "2026-03-14T08:59:31.000Z", "sdkVersions": [ { "sdk": "android", "version": "1.4.0", "events": 96214, "lastEventAt": "2026-03-14T08:59:31.000Z" } ] } ], "handoff": { "appPeople": 3412, "webFirstPeople": 655, "share": 0.192 }}{ "error": { "type": "invalid_request", "code": "string", "message": "string", "param": "string" }}{ "error": { "type": "unauthenticated", "code": "invalid_api_key", "message": "This secret key is not valid." }}{ "error": { "type": "permission_denied", "code": "permission_denied", "message": "Insufficient permissions." }}{ "error": { "type": "not_found", "code": "project_not_found", "message": "There is no project proj_tz4a98xxat96iws9zmbrgj3a, or this credential cannot use it.", "param": "projectId" }}{ "error": { "type": "internal", "code": "internal_error", "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing." }}Response body
application/json
application/json
application/json
application/json
application/json
application/json
Errors
This operation adds no error codes of its own. It can fail with the errors every operation shares, such as unauthenticated; see Errors.
More in Analytics
- Compute insights
POST - Compute charts
POST - Report acquisition
POST - Report acquisition cohorts
POST - List live users
POST
Something wrong or missing on this page? Tell us by email or on Discord.