# Usage

Usage is your workspace's limits and what it has used of them. Read it to see how close you are to a limit.

## Endpoints

- [Get limits and usage](https://docs.soosh.io/reference/api/usage/get-usage/): `GET /v1/usage`

## The Usage object

- `limits` (object): Each limit has a `limit`, where `null` means unlimited. The two rate limits are never `null`: they are always enforced.
  - `api_requests_per_minute` (object): Requests a minute.
    - `limit` (nullable integer): Requests your workspace can make a minute.
    - `used` (integer): Requests made this minute, this one included.
  - `api_messages_per_second` (object): Messages sent a second.
    - `limit` (nullable integer): Messages your workspace can send a second.
  - `contacts` (object): Contacts in your workspace.
    - `limit` (nullable integer): Contacts your workspace can have.
    - `used` (integer): Contacts you have. Counted at most once a minute, so it can be up to 60 seconds old.
  - `broadcast_messages_per_month` (object): Broadcast messages in a month.
    - `limit` (nullable integer): Broadcast messages your workspace can send in the month.
    - `used` (integer): Broadcast messages sent or set aside so far in the month.
    - `period` (string): The month a monthly limit counts, as `YYYY-MM` in UTC.
  - `webhook_endpoints` (object): Webhook endpoints in your workspace.
    - `limit` (nullable integer): Webhook endpoints your workspace can have.
    - `used` (integer): Webhook endpoints you have.
  - `api_keys` (object): Active API keys in your workspace.
    - `limit` (nullable integer): Active API keys your workspace can have.
    - `used` (integer): Active API keys you have.
- `features` (array of strings): The API and webhook features on your plan, such as `api.messages` or `webhooks.contacts`. More may be added.

```json
{
  "limits": {
    "api_requests_per_minute": {
      "limit": 600,
      "used": 12
    },
    "api_messages_per_second": {
      "limit": 20
    },
    "contacts": {
      "limit": 10000,
      "used": 812
    },
    "broadcast_messages_per_month": {
      "limit": 50000,
      "used": 1200,
      "period": "2026-10"
    },
    "webhook_endpoints": {
      "limit": 3,
      "used": 1
    },
    "api_keys": {
      "limit": 5,
      "used": 2
    }
  },
  "features": [
    "api.contacts",
    "api.messages",
    "webhooks.messages"
  ]
}
```