# getWorkflowThrottleUsage

Daily send-limit usage for a throttle-backed workflow (by group id): usedToday vs dailyCap and a per-day history over the last `rangeDays` (1-90, clamped). Null for a workflow with no throttle (only skip-trace-category workflows have one). Answers "am I near my sending limit?".

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "getWorkflowThrottleUsage", "variables": {...} }`
- Scope: `READ`
- Type: query
- Idempotency: a read; rejects `Idempotency-Key`
- Rate-limited: no

## Variables

- `workflowGroupId`: `ID!` (required)
- `rangeDays`: `Int!` (required)

## Response (data, an example)

```json
{
  "workflowAutomationsQuery": {
    "workflowGroupThrottleUsage": {
      "throttleType": "…",
      "dailyCap": 0,
      "usedToday": 0,
      "history": [
        {
          "day": "2026-01-01T00:00:00.000Z",
          "unitsSent": 0
        }
      ]
    }
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "getWorkflowThrottleUsage",
    "variables": {
      "workflowGroupId": "<workflowGroupId>",
      "rangeDays": 10
    }
  }'
```