API

GET /v1/score/{session_id}

A single health score (0–100) for any session — combining crash risk, performance signals, and friction events into one number your agent can act on.

Request

GET https://api.coolcoding.co.uk/v1/score/{session_id}

Path Parameters

Parameter	Type	Required	Description
session_id	string	✅	Session UUID from your ingest events

Query Parameters

Parameter	Type	Required	Default	Description
include_breakdown	boolean	—	false	Return per-signal score breakdown

Example Request

curl https://api.coolcoding.co.uk/v1/score/sess_abc123 \
  -H "Authorization: Bearer cc-YOUR_API_KEY"

Python:

import requests

response = requests.get(
    "https://api.coolcoding.co.uk/v1/score/sess_abc123",
    headers={"Authorization": "Bearer cc-YOUR_API_KEY"},
    params={"include_breakdown": True}
)
print(response.json())

JavaScript:

const response = await fetch(
  `https://api.coolcoding.co.uk/v1/score/sess_abc123?include_breakdown=true`,
  { headers: { "Authorization": "Bearer cc-YOUR_API_KEY" } }
);
console.log(await response.json());

Response

{
  "session_id": "sess_abc123",
  "app_id": "my-app",
  "score": 43,
  "rating": "poor",
  "scored_at": "2026-05-13T09:10:00Z",
  "breakdown": {
    "crash_risk": 18,
    "performance": 55,
    "friction": 38,
    "network": 61
  },
  "signals_evaluated": 12,
  "request_id": "req_9d1f7c",
  "usage": { "credits": 1 }
}

Field	Description
score	0–100. Higher is healthier. Below 50 = agent should investigate.
rating	excellent (80–100) · good (60–79) · fair (40–59) · poor (0–39)
breakdown	Per-dimension scores when include_breakdown=true

Error Responses

Code	Meaning
400	Bad Request — missing or invalid parameters
401	Unauthorized — API key missing or invalid
429	Too Many Requests — rate limit exceeded
432	Plan limit exceeded — upgrade your plan
500	Internal Server Error

429 example:

{
  "error": "Rate limit exceeded. Please reduce request frequency.",
  "retry_after": 60
}

Implement retry logic that respects the retry-after header value.