Skip to main content
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"
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.

​
Framework identifiers

IDFramework
ai-securityAI Security
cis-v8CIS Controls v8
nist-800-53NIST 800-53
nist-csf-2NIST CSF 2.0
hipaaHIPAA
iso-27001ISO 27001
soc-2SOC 2
pci-dssPCI 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.