Skip to content

List networks

GET
/wp-json/wp2/multi-network/v1/networks
curl --request GET \
--url 'https://example.com/wp-json/wp2/multi-network/v1/networks?page=1&per_page=20' \
--header 'X-WP-Nonce: <X-WP-Nonce>'

Lists WordPress networks on this installation (multi-network), with pagination.

page
integer
default: 1

Page number.

per_page
integer
default: 20

Items per page.

search
string

Search string.

Media typeapplication/json
object
items

Array of items (section order, batch, DataTables — depending on the route).

Array<object>
object
network_id

WordPress network ID (WP_Network->id). Same number as GET …/networks/{network_id}.

integer
domain

Network host as stored in wp_site (no scheme). Matches create input after lowercasing.

string
path

Network path with a trailing slash (add_network trailingslashit). Usually /.

string
site_id

Root site ID of this network (WP_Network->site_id), not the network ID.

integer
site_name

Root site blogname (get_blog_option site_id, blogname). Site title, not a network option.

string
network_name

Network option site_name (get_network_option). Set from request network_name when provided.

string
admin_url

Network admin URL {scheme}://{domain}{path}wp-admin/network/. scheme is https when is_ssl().

string format: uri
site_url

Root site URL {scheme}://{domain}{path}.

string format: uri
total

Field “total” as returned or accepted by PHP.

integer
page

Page number.

integer
per_page

Items per page.

integer
total_pages

Field “total_pages” as returned or accepted by PHP.

integer
Example
{
"items": [
{
"network_id": 2,
"domain": "network2.example.com",
"path": "/",
"site_id": 5,
"site_name": "Network root site",
"network_name": "Network Two",
"admin_url": "https://network2.example.com/wp-admin/network/",
"site_url": "https://network2.example.com/"
}
]
}

Not authenticated. WordPress REST: rest_not_logged_in / rest_forbidden. Use cookie + X-WP-Nonce or Application Password.

Media typeapplication/json
object
code

Machine-readable error or event code.

string
message

Message text (log, PIN, or password reset).

string
data

Extra WP_Error or license payload.

object
Examplegenerated
{
"code": "example",
"message": "example",
"data": {}
}

Insufficient capability or invalid REST nonce. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.

Media typeapplication/json
object
code

Machine-readable error or event code.

string
message

Message text (log, PIN, or password reset).

string
data

Extra WP_Error or license payload.

object
Examplegenerated
{
"code": "example",
"message": "example",
"data": {}
}