Resource Limits

Data Limits

This API allows storing data up to 32MB in size.

Rate Limiting

The API allows up to 3,000 requests per minute. Requests are associated with the vault, regardless of the access credentials used to authenticate the request.

Your current rate limit is included as HTTP headers in every API response:

Header Name	Description
x-ratelimit-remaining	The number of requests remaining in the 1-minute window.

If you exceed the rate limit, the API will reject the request with HTTP429 Too Many Requests.

Errors

The API uses standard HTTP status codes to indicate whether the request succeeded or not.

In case of failure, the response body will be JSON in a predefined format. For example, trying to create too many aliases at once results in the following response:

{
    "errors": [
        {
            "status": 400,
            "title": "Bad request",
            "detail": "Too many values (limit: 20)",
            "href": "https://api.sandbox.verygoodvault.com/aliases"
        }
    ]
}