Retrieves a list of all domains registered by you, along with their corresponding metadata. The order of domains in the response is unspecified and non-deterministic. Newly registered domains will not necessarily be added to the end of this list.
HTTP request
GET https://gmailpostmastertools.googleapis.com/v2beta/domains
The URL uses gRPC Transcoding syntax.
Query parameters
| Parameters | |
|---|---|
pageSize
|
Optional. Requested page size. Server may return fewer domains than requested. If unspecified, the default value for this field is 10. The maximum value for this field is 200. |
pageToken
|
Optional. The nextPageToken value returned from a previous List request, if any. |
Request body
The request body must be empty.
Response body
Response message for domains.list.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"domains"
:
[
{
object (
|
| Fields | |
|---|---|
domains[]
|
The domains that have been registered by the user. |
nextPageToken
|
Token to retrieve the next page of results, or empty if there are no more results in the list. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/postmaster -
https://www.googleapis.com/auth/postmaster.domain
For more information, see the Authorization guide .

