Score AI readiness answers

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.

post/v1/ai-readiness/score

Request

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

Headers

Idempotency-Keystring

Optional client-chosen key. Every endpoint is stateless and side-effect free, so identical requests always produce identical results; the key is echoed back with an Idempotency-Status header so clients can confirm safe replay.

Request body

answersinteger[] required

Either 16 option indices (0-4, all questions in order) or 15 point values (1-5, scored questions only, in order)

Response

The scored result

scoreinteger required
scalestring
averagenumber

Mean of scored answers on the 1-5 scale

pillarsobject required

Keyed strategy/people/data/change

weakestPillar'strategy' | 'people' | 'data' | 'change' required
scoredQuestionsinteger
interactiveVersionstring uri
nextStepstring

Changes

No recorded changes to this operation across all 1 revision of this API.