wp_remote_request( string $url, array $args = array() )

Performs an HTTP request and returns its response.

Description

There are other API functions available which abstract away the HTTP method:

See also

Parameters

$url

(string) (Required) URL to retrieve.

$args

(array) (Optional) Request arguments.

Default value: array()

Return

(array|WP_Error) The response array or a WP_Error on failure.

  • 'headers'
    (string[]) Array of response headers keyed by their name.
  • 'body'
    (string) Response body.
  • 'response'
    (array) Data about the HTTP response.
    • 'code'
      (int|false) HTTP response code.
    • 'message'
      (string|false) HTTP response message.
  • 'cookies'
    (WP_HTTP_Cookie[]) Array of response cookies.
  • 'http_response'
    (WP_HTTP_Requests_Response|null) Raw HTTP response object.

Source

File: wp-includes/http.php

function wp_remote_request( $url, $args = array() ) {
	$http = _wp_http_get_object();
	return $http->request( $url, $args );
}

Changelog

Version Description
2.7.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_remote_request