Scores

GET /api/v1/scores

Returns the most recent completed assessment score for each framework in your organization. If you have completed multiple assessments for the same framework, only the latest result is returned. Required scope: scores:read

Request

curl https://assess.ayliea.com/api/v1/scores \
  -H "X-API-Key: ayliea_pk_YOUR_API_KEY"

import requests

response = requests.get(
    "https://assess.ayliea.com/api/v1/scores",
    headers={"X-API-Key": "ayliea_pk_YOUR_API_KEY"}
)
scores = response.json()["scores"]

const response = await fetch("https://assess.ayliea.com/api/v1/scores", {
  headers: { "X-API-Key": "ayliea_pk_YOUR_API_KEY" },
});
const { scores } = await response.json();

This endpoint does not accept query parameters. It returns all frameworks with completed assessments.

Response

{
  "scores": [
    {
      "framework_id": "ai-security",
      "overall_score": 72,
      "grade": "C",
      "completed_at": "2026-03-15T14:30:00Z"
    },
    {
      "framework_id": "nist-csf-2",
      "overall_score": 85,
      "grade": "B",
      "completed_at": "2026-03-10T09:15:00Z"
    }
  ]
}

Response fields

array

required

Array of score objects, one per framework with a completed assessment.

Show Score object fields

string

required

Framework identifier. One of: ai-security, cis-v8, nist-800-53, nist-csf-2, hipaa, iso-27001, soc-2, pci-dss.

number

required

Weighted aggregate score from 0 to 100.

string

required

Letter grade derived from the overall score: A (90-100), B (80-89), C (70-79), D (60-69), F (0-59).

string

required

ISO 8601 UTC timestamp of when the assessment was completed.

Framework identifiers

ID	Framework
`ai-security`	AI Security
`cis-v8`	CIS Controls v8
`nist-800-53`	NIST 800-53
`nist-csf-2`	NIST CSF 2.0
`hipaa`	HIPAA
`iso-27001`	ISO 27001
`soc-2`	SOC 2
`pci-dss`	PCI DSS

Notes

Only completed assessments are included. In-progress assessments do not appear.
If no assessments have been completed, the scores array is empty.
Scores are calculated using weighted category averages. See Scoring for details on how scores are computed.

API Reference

Endpoints

Request

Response

Response fields

Framework identifiers

Notes

​Request

​Response

​Response fields

​Framework identifiers

​Notes

Request

Response

Response fields

Framework identifiers

Notes