# Detailed eligibility check error messages and resolution steps

> The Eligibility Check API now returns detailed AAA error messages that specify why the payer rejected the transaction and recommended follow-up steps.

Published Apr 12, 2024

Updated Nov 10, 2026

Product: Eligibility checks

Note

This entry refers to the [Legacy Real-Time Eligibility Check JSON](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-eligibility-legacy) endpoint. We now have a [redesigned version](https://www.stedi.com/changelog/introducing-our-redesigned-json-real-time-eligibility-check-api) of that endpoint.

We strongly recommend the [redesigned endpoint](https://www.stedi.com/docs/healthcare/api-reference/post-eligibility-check) for new implementations. Its request and response shapes are more intuitive for both developers and AI agents, which speeds up integration. We still fix bugs in the legacy endpoint, but it's no longer under active development.

The [Legacy Real-Time Eligibility Check JSON endpoint](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-eligibility-legacy) now returns detailed AAA error messages that specify why the payer rejected the transaction and any recommended follow-up actions. Stedi includes this information in the `aaaErrors` object in the response JSON.

The following example shows an error at the `subscriber` level:

Visit our [eligibility check troubleshooting](https://www.stedi.com/docs/healthcare/eligibility-troubleshooting#payer-aaa-errors) docs for a complete list of all possible error types and resolution steps.