Title: get_status_header_desc
Published: April 25, 2014
Last modified: May 20, 2026

---

# get_status_header_desc( int $code ): string

## In this article

 * [Parameters](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#wp--skip-link--target)

Retrieves the description for the HTTP status.

## 󠀁[Parameters](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#parameters)󠁿

 `$code`intrequired

HTTP status code.

## 󠀁[Return](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#return)󠁿

 string Status description if found, an empty string otherwise.

## 󠀁[Source](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#source)󠁿

    ```php
    function get_status_header_desc( $code ) {
    	global $wp_header_to_desc;

    	$code = absint( $code );

    	if ( ! isset( $wp_header_to_desc ) ) {
    		$wp_header_to_desc = array(
    			100 => 'Continue',
    			101 => 'Switching Protocols',
    			102 => 'Processing',
    			103 => 'Early Hints',

    			200 => 'OK',
    			201 => 'Created',
    			202 => 'Accepted',
    			203 => 'Non-Authoritative Information',
    			204 => 'No Content',
    			205 => 'Reset Content',
    			206 => 'Partial Content',
    			207 => 'Multi-Status',
    			226 => 'IM Used',

    			300 => 'Multiple Choices',
    			301 => 'Moved Permanently',
    			302 => 'Found',
    			303 => 'See Other',
    			304 => 'Not Modified',
    			305 => 'Use Proxy',
    			306 => 'Reserved',
    			307 => 'Temporary Redirect',
    			308 => 'Permanent Redirect',

    			400 => 'Bad Request',
    			401 => 'Unauthorized',
    			402 => 'Payment Required',
    			403 => 'Forbidden',
    			404 => 'Not Found',
    			405 => 'Method Not Allowed',
    			406 => 'Not Acceptable',
    			407 => 'Proxy Authentication Required',
    			408 => 'Request Timeout',
    			409 => 'Conflict',
    			410 => 'Gone',
    			411 => 'Length Required',
    			412 => 'Precondition Failed',
    			413 => 'Request Entity Too Large',
    			414 => 'Request-URI Too Long',
    			415 => 'Unsupported Media Type',
    			416 => 'Requested Range Not Satisfiable',
    			417 => 'Expectation Failed',
    			418 => 'I\'m a teapot',
    			421 => 'Misdirected Request',
    			422 => 'Unprocessable Entity',
    			423 => 'Locked',
    			424 => 'Failed Dependency',
    			425 => 'Too Early',
    			426 => 'Upgrade Required',
    			428 => 'Precondition Required',
    			429 => 'Too Many Requests',
    			431 => 'Request Header Fields Too Large',
    			451 => 'Unavailable For Legal Reasons',

    			500 => 'Internal Server Error',
    			501 => 'Not Implemented',
    			502 => 'Bad Gateway',
    			503 => 'Service Unavailable',
    			504 => 'Gateway Timeout',
    			505 => 'HTTP Version Not Supported',
    			506 => 'Variant Also Negotiates',
    			507 => 'Insufficient Storage',
    			510 => 'Not Extended',
    			511 => 'Network Authentication Required',
    		);
    	}

    	if ( isset( $wp_header_to_desc[ $code ] ) ) {
    		return $wp_header_to_desc[ $code ];
    	} else {
    		return '';
    	}
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/functions.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/functions.php#L1364)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/functions.php#L1364-L1444)

## 󠀁[Related](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#related)󠁿

| Uses | Description | 
| [absint()](https://developer.wordpress.org/reference/functions/absint/)`wp-includes/load.php` |

Converts a value to non-negative integer.

  |

| Used by | Description | 
| [WP_oEmbed_Controller::get_proxy_item()](https://developer.wordpress.org/reference/classes/wp_oembed_controller/get_proxy_item/)`wp-includes/class-wp-oembed-controller.php` |

Callback for the proxy API endpoint.

  | 
| [WP_HTTP_Requests_Response::to_array()](https://developer.wordpress.org/reference/classes/wp_http_requests_response/to_array/)`wp-includes/class-wp-http-requests-response.php` |

Converts the object to a [WP_Http](https://developer.wordpress.org/reference/classes/wp_http/) response array.

  | 
| [_oembed_rest_pre_serve_request()](https://developer.wordpress.org/reference/functions/_oembed_rest_pre_serve_request/)`wp-includes/embed.php` |

Hooks into the REST API output to print XML instead of JSON.

  | 
| [WP_oEmbed_Controller::get_item()](https://developer.wordpress.org/reference/classes/wp_oembed_controller/get_item/)`wp-includes/class-wp-oembed-controller.php` |

Callback for the embed API endpoint.

  | 
| [status_header()](https://developer.wordpress.org/reference/functions/status_header/)`wp-includes/functions.php` |

Sets HTTP status header.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/get_status_header_desc/?output_format=md#changelog)󠁿

| Version | Description | 
| [6.6.0](https://developer.wordpress.org/reference/since/6.6.0/) | Added status code 425. | 
| [5.1.0](https://developer.wordpress.org/reference/since/5.1.0/) | Added status code 103. | 
| [4.5.0](https://developer.wordpress.org/reference/since/4.5.0/) | Added status codes 308, 421, and 451. | 
| [3.9.0](https://developer.wordpress.org/reference/since/3.9.0/) | Added status codes 418, 428, 429, 431, and 511. | 
| [2.3.0](https://developer.wordpress.org/reference/since/2.3.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fget_status_header_desc%2F)
before being able to contribute a note or feedback.