Docs

Project Metrics

Retrieve the lifetime metrics of every active link in a project environment, sorted by views.

GEThttps://sdk.sqd.link/api/v1/sdk/metrics_for_project

Fetch the lifetime metrics of every active link in the project, for the environment named by the ENVIRONMENT header.

Headers

PROJECT-KEYstringrequired

Your SDK project key. Found in Dashboard → Developer → API Key.

ENVIRONMENTstringrequired

Target environment. Use production or test. Any other value returns 400.

There are no query parameters. The response includes every active link in the environment, sorted by views in descending order, in a single page.

Example request

Bash
curl -X GET "https://sdk.sqd.link/api/v1/sdk/metrics_for_project" \
  -H "PROJECT-KEY: your-api-key" \
  -H "ENVIRONMENT: production"

Response

An array of link objects, each with the same shape as the metrics object of Link Metrics:

JSON
[
  {
    "id": 4821,
    "name": "Summer sale",
    "path": "2c1e79",
    "title": "Summer Sale",
    "active": true,
    "sdk_generated": true,
    "tags": ["campaign", "summer"],
    "tracking_campaign": "summer_2025",
    "total_views": 1250,
    "total_opens": 840,
    "total_installs": 312,
    "total_reinstalls": 18,
    "total_time_spent": 96420,
    "total_reactivations": 41,
    "total_app_opens": 2210,
    "total_user_referred": 7,
    "total_revenue": 149900
  },
  {
    "id": 4790,
    "name": "Onboarding email",
    "path": "8f21ac",
    "total_views": 630,
    "total_opens": 402,
    "total_installs": 95,
    "total_reinstalls": 3,
    "total_time_spent": 31877,
    "total_reactivations": 12,
    "total_app_opens": 1104,
    "total_user_referred": 0,
    "total_revenue": 0
  }
]

Links that are deactivated in the dashboard are not returned. Totals cover each link's whole lifetime, subject to your project's analytics retention window.

Projects with many links receive a large response, since the endpoint is not paginated. Cache the result on your side rather than polling it frequently.

See Errors for the shared status codes.

Edit this page on GitHubLast updated 2026-09-15