Usage limits

As the Google Vault API is a shared service, we apply quotas and limitations to make sure it's used fairly by all users and to protect the overall health of the Google Workspace system.

Product limits

You can have no more than 20 exports in progress across your organization.

API request quotas

Each organization is allowed 600 matter reads per minute, across all projects and users, including requests through the Vault API and vault.google.com.

The following tables list the per-minute per-project request limits:

Read requests per minute per project
Export, matter, and saved query 120
Hold 240
Long-running operation 300
Write requests per minute per project
Export 20
Hold 60
Matter permissions 30
Matter 60
Saved query 45
Search (count) requests per minute per project
Search counts 20

Quota usage by method

The quota used by a request depends on the method called. The following table lists the per-method quota usage:

Method Quota costs
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete
1 matter read
1 matter write
matters.count 1 count
matters.get 1 matter read
matters.list 10 matter reads
matters.addPermissions
matters.removePermissions
1 matter read
1 matter write
1 matter permissions write
matters.exports.create 1 export read
10 export writes
matters.exports.delete 1 export write
matters.exports.get 1 export read
matters.exports.list 5 export reads
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update
1 matter read
1 matter write
1 hold read
1 hold write
matters.holds.list 1 matter read
3 hold reads
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list
1 matter read
1 matter write
1 hold read
1 hold write
matters.savedQueries.create
matters.savedQueries.delete
1 matter read
1 matter write
1 saved query read
1 saved query write
matters.savedQueries.get 1 matter read
1 saved query read
matters.savedQueries.list 1 matter read
3 saved query reads
operations.get 1 long-running operation read

Resolve time-based quota errors

If you exceed a per-minute or per-organization quota, you usually get a 429: Too many requests HTTP status code response.

For all time-based errors (maximum of N requests per X minutes), we recommend your code catches the exception and, using an exponential backoff algorithm, implement a small delay before trying again. If requests are still unsuccessful, it's important the delays between requests increase over time until the request is successful. Generally, you should use a truncated exponential backoff. To learn how to use exponential backoff, go to Retry strategy.

Request a quota increase

Depending on your project's resource usage, you might want to request a quota increase. API calls by a service account are considered to be utilizing a single account, so you might need a higher per-user, per-project quota in that scenario. Applying for an increased quota doesn't guarantee approval. Large quota increases can take longer to be approved.

To learn more, see the resources below:

Pricing

All use of Google Vault API is available at no additional cost to Google Workspace customers.