Method: matters.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists matters the requestor has access to.
HTTP request
GET https://vault.googleapis.com/v1/matters
The URL uses gRPC Transcoding syntax.
Query parameters
| Parameters |
pageSize |
integer
The number of matters to return in the response. Default and maximum are 100.
|
pageToken |
string
The pagination token as returned in the response.
|
view |
enum (MatterView)
Specifies how much information about the matter to return in response.
|
state |
enum (State)
If set, lists only matters with the specified state. The default lists matters of all states.
|
Request body
The request body must be empty.
Response body
Provides the list of matters.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"matters": [
{
object (Matter)
}
],
"nextPageToken": string
} |
| Fields |
matters[] |
object (Matter)
List of matters.
|
nextPageToken |
string
Page token to retrieve the next page of results in the list.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/ediscovery.readonlyhttps://www.googleapis.com/auth/ediscovery
For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-17 UTC.
[null,null,["Last updated 2025-03-17 UTC."],[],[],null,["# Method: matters.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListMattersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists matters the requestor has access to.\n\n### HTTP request\n\n`GET https://vault.googleapis.com/v1/matters`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The number of matters to return in the response. Default and maximum are 100. |\n| `pageToken` | `string` The pagination token as returned in the response. |\n| `view` | `enum (`[MatterView](/workspace/vault/reference/rest/v1/MatterView)`)` Specifies how much information about the matter to return in response. |\n| `state` | `enum (`[State](/workspace/vault/reference/rest/v1/matters#State)`)` If set, lists only matters with the specified state. The default lists matters of all states. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nProvides the list of matters.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------|\n| ``` { \"matters\": [ { object (/workspace/vault/reference/rest/v1/matters#Matter) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------|\n| `matters[]` | `object (`[Matter](/workspace/vault/reference/rest/v1/matters#Matter)`)` List of matters. |\n| `nextPageToken` | `string` Page token to retrieve the next page of results in the list. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/ediscovery.readonly`\n- `https://www.googleapis.com/auth/ediscovery`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
