Title: ErrorMessageExtractor::extractFromResponseData
Published: May 20, 2026

---

# ErrorMessageExtractor::extractFromResponseData( mixed $data ): string|null

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#description)
 * [Parameters](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#wp--skip-link--target)

Extracts error message from API response data.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#description)󠁿

Handles common error response formats:

 * { “error”: { “message”: “Error text” } }
 * { “error”: “Error text” }
 * { “message”: “Error text” }

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#parameters)󠁿

 `$data`mixedrequired

The response data to extract error message from.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#return)󠁿

 string|null The extracted error message, or null if none found.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#source)󠁿

    ```php
    public static function extractFromResponseData($data): ?string
    {
        if (!is_array($data)) {
            return null;
        }
        // Handle [ { "error": { "message": "Error text" } } ]
        if (isset($data[0]) && is_array($data[0]) && isset($data[0]['error']) && is_array($data[0]['error']) && isset($data[0]['error']['message']) && is_string($data[0]['error']['message'])) {
            return $data[0]['error']['message'];
        }
        // Handle { "error": { "message": "Error text" } }
        if (isset($data['error']) && is_array($data['error']) && isset($data['error']['message']) && is_string($data['error']['message'])) {
            return $data['error']['message'];
        }
        // Handle { "error": "Error text" }
        if (isset($data['error']) && is_string($data['error'])) {
            return $data['error'];
        }
        // Handle { "message": "Error text" }
        if (isset($data['message']) && is_string($data['message'])) {
            return $data['message'];
        }
        return null;
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/php-ai-client/src/providers/http/util/errormessageextractor.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/php-ai-client/src/Providers/Http/Util/ErrorMessageExtractor.php#L30)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/php-ai-client/src/Providers/Http/Util/ErrorMessageExtractor.php#L30-L52)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#related)󠁿

| Used by | Description | 
| [ServerException::fromServerErrorResponse()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-serverexception/fromservererrorresponse/)`wp-includes/php-ai-client/src/Providers/Http/Exception/ServerException.php` |

Creates a ServerException from a server error response.

  | 
| [ClientException::fromClientErrorResponse()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-clientexception/fromclienterrorresponse/)`wp-includes/php-ai-client/src/Providers/Http/Exception/ClientException.php` |

Creates a ClientException from a client error response (4xx).

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/?output_format=md#changelog)󠁿

| Version | Description | 
| [0.2.0](https://developer.wordpress.org/reference/since/0.2.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwordpress-aiclient-providers-http-util-errormessageextractor%2Fextractfromresponsedata%2F)
before being able to contribute a note or feedback.