Enhanced Error Messaging for Ads Insights Async API

We are continuously working to improve the developer experience with our APIs. To provide greater transparency and enable developers to build more resilient applications, we are enhancing the error reporting for the Ads Insights Async API GET {AD_REPORT_RUN_ID} endpoint.

Beginning with the next Graph API version V25.0 which will be released on Feb 18, 2026, developers will have access to detailed error information when an asynchronous report fails, enabling easier diagnosis of failures, and improving the efficiency of their API integrations. For any developers who currently have access to the error_code field, the type will be changed from uint to int

What's Changing?

We are introducing the following new default fields to the response of the Ads Insights Async API GET {AD_REPORT_RUN_ID} endpoint for all applications:

• error_code: The error code. Note: Field will be changed from uint to int for any developers who currently have access to it
• error_message: A message corresponding to the error_code.
• error_subcode: The specific subcode for the error.
• error_user_title: A user-friendly title for the error subcode.
• error_user_msg: A user-friendly message detailing the error subcode.

These fields will be populated when a report run fails. We encourage you to review your API integration to ensure compatibility with the new default fields in the response.

This update is planned to be released with the next Graph API version. We recommend developers check the Graph API Changelog for the most up-to-date information. Developer documentation has also been updated to reflect these changes.