XCA error handling
The NIR XCA error handling page provides technical information to users on error codes and error handling for the NIR XCA endpoints.
Error handling
NIR error handling is a technical guide to how error codes, error severities and HTTP statuses are determined and returned to the client.
The primary purpose of this document is to provide a technical reference for teams that are either developing or supporting NIR. However, it may also be used to inform content that will eventually be uploaded to the NIR API website.
Note: This is a living document and may be updated as new functionality and features are added to NIR - check with a member of the NIR delivery squad for the most up to date information.
In scope
- How IHE error codes are consolidated and reported to the client from NIR.
- How ResponseStatusType is determined.
- How HTTP status codes are determined.
- How error severity is determined.
- Sample error messages.
Out of scope
- Specific instructions for how the requesting systems display or handle these errors.
- Guidance on what to do in the event of an incident.
Last edited: 3 June 2026 2:28 pm