> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ayliea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CodeGroup>
  ```bash curl theme={null}
  curl https://assess.ayliea.com/api/v1/scores \
    -H "X-API-Key: ayliea_pk_YOUR_API_KEY"
  ```

  ```python Python theme={null}
  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"]
  ```

  ```javascript Node.js theme={null}
  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();
  ```
</CodeGroup>

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

## Response

```json theme={null}
{
  "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

<ResponseField name="scores" type="array" required>
  Array of score objects, one per framework with a completed assessment.

  <Expandable title="Score object fields">
    <ResponseField name="framework_id" type="string" required>
      Framework identifier. One of: `ai-security`, `cis-v8`, `nist-800-53`, `nist-csf-2`, `hipaa`, `iso-27001`, `soc-2`, `pci-dss`.
    </ResponseField>

    <ResponseField name="overall_score" type="number" required>
      Weighted aggregate score from 0 to 100.
    </ResponseField>

    <ResponseField name="grade" type="string" required>
      Letter grade derived from the overall score: `A` (90-100), `B` (80-89), `C` (70-79), `D` (60-69), `F` (0-59).
    </ResponseField>

    <ResponseField name="completed_at" type="string" required>
      ISO 8601 UTC timestamp of when the assessment was completed.
    </ResponseField>
  </Expandable>
</ResponseField>

## 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](/product/scoring) for details on how scores are computed.