Scores

Retrieve the latest completed assessment scores per framework for your organization.

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

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

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

scores · array · required

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

Show Score object fields

framework_id · string · required

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

overall_score · number · required

Weighted aggregate score from 0 to 100.

grade · string · required

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

completed_at · 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.