# Get Usage Summary

Check how many tasks you have used this period and how close you are to your limit.

`GET https://connect.mindcloud.co/v2/usage`

Permissions: `subscription:view`.

## Parameters

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/usage' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `periodStart` (string): First day of the current period.
- `periodEnd` (string): Last day of the current period.
- `usedTasks` (number): Tasks used so far this period.
- `taskLimit` (number): Your task limit for the period.
- `softLimitEnabled` (boolean): True when passing the limit warns instead of blocking.