# Read this period's usage

What the workspace consumed in the period it is paying for: seats in use against seats paid, credits spent and left, messages a person sent, and live file bytes held. The window is the subscription's own period, or the last thirty days when there is no subscription, and the answer states which.

Access class: `workspace`.

## Endpoint

`GET /v1/billing/usage`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "credits": {
      "remaining": 1.5,
      "used": 1.5
    },
    "messagesSent": 1.5,
    "period": {},
    "seats": {
      "paid": 1.5,
      "used": 1.5
    },
    "storageBytes": 1.5
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```