# This month's usage and pitch cap

> This month's usage and pitch cap. GET /v1/productions/usage in the Raylight API.

### GET /v1/productions/usage

**This month's usage and pitch cap**

Auth: `Authorization: Bearer rl_live_...` with the `productions` scope.

Parameters:

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `workspaceId` | query | uuid | no |  |

Responses:

| Status | Meaning |
| --- | --- |
| 200 | Counts and caps for the calendar month. |
| 400 | Invalid request. |
| 401 | Missing, invalid or revoked key. |
| 403 | The key lacks the scope, or the key's owner has view-only access to the workspace (code `forbidden`). |
| 404 | Not found. |
| 429 | Rate limited, or a monthly cap reached. |

Response body (200):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `plan` | string | yes |  |
| `productionsThisMonth` | integer | yes |  |
| `pitchesThisMonth` | integer | yes |  |
| `pitchesCap` | integer | yes |  |
| `creditsCharged` | integer | yes |  |

Example (curl):

```bash
curl https://api.raylight.app/v1/productions/usage \
  -H "Authorization: Bearer $RAYLIGHT_API_KEY"
```

## More

- Previous: [Create a production](https://www.raylight.app/docs/reference/post-v1-productions.md)
- Next: [Read a production](https://www.raylight.app/docs/reference/get-v1-productions-id.md)
- All docs: https://www.raylight.app/llms.txt
- Everything in one file: https://www.raylight.app/llms-full.txt
- OpenAPI: https://api.raylight.app/v1/openapi.json