---
title: "Score AI readiness answers"
method: POST
path: "/v1/ai-readiness/score"
---

# Score AI readiness answers

`POST /v1/ai-readiness/score`

## Request

- Base URL: `https://shipshapedata.com/api`
- URL: `https://shipshapedata.com/api/v1/ai-readiness/score`
- Auth: none declared

Stateless scoring with the same maths as shipshapedata.com/ai-readiness: mean of the 15 scored answers mapped to five maturity bands. Returns a 0-100 score, band guidance, per-area averages, and advice for the weakest area. Nothing is stored, so repeat calls with the same body always return the same result.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `answers` integer[], required: Either 16 option indices (0-4, all questions in order) or 15 point values (1-5, scored questions only, in order)

## Response `200`

The scored result

- ReadinessResult
  - `score` integer, required
  - `scale` string
  - `average` number: Mean of scored answers on the 1-5 scale
  - `band` object, required
    - `name` string, required
    - `guidance` string[], required
  - `pillars` object, required: Keyed strategy/people/data/change
  - `weakestPillar` 'strategy' | 'people' | 'data' | 'change', required
  - `scoredQuestions` integer
  - `interactiveVersion` string, uri
  - `nextStep` string

## Other responses

- `400`: Invalid input

---

[API](https://skmtc.dev/shipshapedata/apis/shipshape-data-api.md) · [All operations](https://skmtc.dev/shipshapedata/apis/shipshape-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shipshapedata/apis/shipshape-data-api/revisions/2d494a3e5dbc?raw)