v5

latestOpenAPI 3.0.1raw.githubusercontent.com2026-05-207720.6 KB
Multiple Offenders

Retrieve the current Complexity of Need levels for multiple offenders

This endpoint returns a JSON array containing the current Complexity of Need entry for multiple offenders.

The response array:

  • will exclude offenders whose Complexity of Need level is not known (i.e. these would result in a 404 Not Found error on the single GET endpoint)
  • will exclude offenders without a current active level
  • is not sorted in the same order as the request body
  • is not paginated
post/v1/complexity-of-need/multiple/offender-no

Request body

OffenderNo[] required

A JSON array of NOMIS Offender Numbers

Example request

[
  "A0000AA",
  "B0000BB",
  "C0000CC"
]

Response

OK

offenderNostring required

NOMIS Offender Number

level'low' | 'medium' | 'high' required

Complexity of Need Level

sourceUserstring

The NOMIS username that supplied this Complexity of Need entry

sourceSystemstring required

The OAuth Client ID of the system that created this entry

notesstring

Free-text notes for this entry

createdTimeStampstring date_time required

The date & time this entry was created (in RFC 3339 format)

updatedTimeStampstring date_time required

The date & time this entry was updated (in RFC 3339 format)

activeboolean required

Whether it is active or not

Example response

[
  {
    "offenderNo": "A0000AA",
    "level": "low",
    "sourceUser": "JSMITH_GEN",
    "sourceSystem": "hmpps-api-client-id",
    "createdTimeStamp": "2021-03-02T17:18:46.457Z",
    "updatedTimeStamp": "2021-03-02T17:18:46.457Z"
  }
]