# getSendingLimits

How much can we text and email today? Per line, brand (team) and mailbox: used / cap / remaining today (text segments; null cap = no limit; a mailbox also meters recipients, and the tighter of its two binds), a line's last-7-day volume, and the sending queue. Read-only. Count only lines with canSendSms and not isBurned. textingReadiness is the org's texting registration: canText, and reason when not (NO_REGISTRATION = none filed; MANAGED_* = Goliath-managed registration in review or failed; BYO_* = their own Twilio account). Read it first for a registration question; never fill in or submit one for them.

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

## Variables

None.

## Response (data, an example)

```json
{
  "currentUser": {
    "id": "<ID>",
    "organization": {
      "id": "<ID>",
      "textingReadiness": {
        "canText": true,
        "reason": "NO_REGISTRATION"
      },
      "twilioPhoneNumbers": [
        {
          "id": "<ID>",
          "e164Number": "…",
          "canSendSms": true,
          "isBurned": true,
          "smsDailyThrottle": {
            "used": 0,
            "cap": 0,
            "remaining": 0
          },
          "smsWarmUpVolume": {
            "last7Days": 0
          }
        }
      ],
      "smsBrandBudgets": [
        {
          "id": "<ID>",
          "phoneNumberIds": [
            "<ID>"
          ],
          "dailyThrottle": {
            "used": 0,
            "cap": 0,
            "remaining": 0,
            "utcDayEnd": "2026-01-01T00:00:00.000Z"
          }
        }
      ]
    }
  },
  "oauthQuery": {
    "myActiveEmailIdentities": [
      {
        "id": "<ID>",
        "email": "…",
        "dailyMessagesThrottle": {
          "used": 0,
          "cap": 0,
          "remaining": 0
        },
        "dailyRecipientsThrottle": {
          "used": 0,
          "cap": 0,
          "remaining": 0
        }
      }
    ]
  },
  "workflowAutomationsQuery": {
    "sendingQueue": {
      "queued": 0,
      "held": 0,
      "heldReason": "DAILY_CAP",
      "heldUntil": "2026-01-01T00:00:00.000Z",
      "nextSendAt": "2026-01-01T00:00:00.000Z"
    }
  }
}
```

## Example

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