Title: Requests::request_multiple
Published: August 16, 2016
Last modified: November 2, 2022

---

# Requests::request_multiple( array $requests, array $options = array() ): array

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/requests/request_multiple/?output_format=md#description)
 * [Parameters](https://developer.wordpress.org/reference/classes/requests/request_multiple/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/requests/request_multiple/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/requests/request_multiple/?output_format=md#source)

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

Send multiple HTTP requests simultaneously

## 󠀁[Description](https://developer.wordpress.org/reference/classes/requests/request_multiple/?output_format=md#description)󠁿

The `$requests` parameter takes an associative or indexed array of request fields.
The key of each request can be used to match up the request with the returned data,
or with the request passed into your `multiple.request.complete` callback.

The request fields value is an associative array with the following keys:

 * `url`: Request URL Same as the `$url` parameter to [Requests::request](https://developer.wordpress.org/reference/classes/Requests/request/)(
   string, required)
 * `headers`: Associative array of header fields. Same as the `$headers` parameter
   to [Requests::request](https://developer.wordpress.org/reference/classes/Requests/request/)(
   array, default: `array()`)
 * `data`: Associative array of data fields or a string. Same as the `$data` parameter
   to [Requests::request](https://developer.wordpress.org/reference/classes/Requests/request/)(
   array|string, default: `array()`)
 * `type`: HTTP request type (use Requests constants). Same as the `$type` parameter
   to [Requests::request](https://developer.wordpress.org/reference/classes/Requests/request/)(
   string, default: `Requests::GET`)
 * `cookies`: Associative array of cookie name to value, or cookie jar.
   (array|[Requests_Cookie_Jar](https://developer.wordpress.org/reference/classes/requests_cookie_jar/))

If the `$options` parameter is specified, individual requests will inherit options
from it. This can be used to use a single hooking system, or set all the types to`
Requests::POST`, for example.

In addition, the `$options` parameter takes the following global options:

 * `complete`: A callback for when a request is complete. Takes two parameters, 
   a [Requests_Response](https://developer.wordpress.org/reference/classes/requests_response/)/
   Requests_Exception reference, and the ID from the request array (Note: this can
   also be overridden on a per-request basis, although that’s a little silly) (callback)

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

 `$requests`arrayrequired

Requests data (see description for more information)

`$options`arrayoptional

Global and default options (see [Requests::request](https://developer.wordpress.org/reference/classes/Requests/request/))

Default:`array()`

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

 array Responses (either [Requests_Response](https://developer.wordpress.org/reference/classes/requests_response/)
or a [Requests_Exception](https://developer.wordpress.org/reference/classes/requests_exception/)
object)

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

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-requests.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/class-requests.php#L429)

## User Contributed Notes

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