Community Payback and Delius
Integration service enabling the Community Payback service to retrieve and update details about Unpaid Work appointments and projects from NDelius.
Business Need
The Community Payback service requires access to up-to-date information about Unpaid Work appointments and projects for people on probation. This integration service provides APIs to:
- Retrieve Unpaid Work appointment, session and project details from NDelius
- Update Unpaid Work appointments and project records in NDelius
Interfaces
API Endpoints
The service exposes RESTful API endpoints for the Community Payback service to:
- Search for and retrieve Unpaid Work appointments and project details
- Create, update, or delete Unpaid Work appointments and projects
API endpoints are secured and require appropriate roles via HMPPS Auth.
Message/Event Handling
(If the service consumes or produces domain events, describe them here. Otherwise, remove this section.)
Context Map
Authorisation
API endpoints are protected by roles supplied by the HMPPS Auth client. Only authorised clients can access or modify Unpaid Work data.
| API Endpoint | Required Role |
|---|---|
| /projects/** | ROLE_COMMUNITY_PAYBACK_UNPAID_WORK |
| /providers/** | ROLE_COMMUNITY_PAYBACK_UNPAID_WORK |
| /supervisors/** | ROLE_COMMUNITY_PAYBACK_UNPAID_WORK |
| /reference-data/** | ROLE_COMMUNITY_PAYBACK_UNPAID_WORK |
API Reference
This page was last reviewed on 16 October 2025.
It needs to be reviewed again on 16 February 2026
by the page owner #probation-integration-team
.
This page was set to be reviewed before 16 February 2026
by the page owner #probation-integration-team.
This might mean the content is out of date.