---
title: "Get Rate Limits"
method: GET
path: "/v1/rate-limits"
tags: ["Rate Limit"]
---

# Get Rate Limits

`GET /v1/rate-limits`

Get the rate limits for a specific entity.
For instance, could fetch rate limits applied to a specific vehicle.

The rate limit domain specifies the context the limit is applied to, e.g. for start / stop charge commands.


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Query parameters

- `objectId` string, required — The ID of the object to get the rate limits for
- `domain` 'VEHICLE', required

## Response `200`

Successful Response

- RateLimit[]
  - `remainingRequests` integer, required — The count of remaining requests before the rate limit is breached
  - `maxRequests` integer, required — The maximum count of requests on the rate limit over the window period
  - `domain` 'VEHICLE', required
  - `windowSizeSeconds` integer, required — The window size in seconds over which the rate limit is calculated
  - `objectId` string, required — The ID of the object on which the rate limit is applied
  - `key` 'BMW_ENERGY_API_COMMANDS' | 'BMW_ENERGY_API_STOP_COMMANDS' | 'BMW_ENERGY_API_COMMANDS_AND_FETCH_STATE', required

---

[API](https://skmtc.net/volteras/apis/volteras-connect.md) · [All operations](https://skmtc.net/volteras/apis/volteras-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/volteras/volteras-connect/versions/bcb08bba814d/schema)