> ## Documentation Index > Fetch the complete documentation index at: https://docs.coldsend.pro/llms.txt > Use this file to discover all available pages before exploring further. # Get per-inbox daily quotas for a campaign > **Get live daily quota state for every inbox assigned to a campaign** Returns the effective daily send limit and current usage per inbox, combining the inbox-level hard cap, campaign override, ramp-up schedule, and the live Redis counter. Useful for building send-capacity dashboards or pre-flight checks before kicking off a campaign. ## OpenAPI ````yaml /public_openapi.json get /api/public/v1/sender-accounts/quotas openapi: 3.0.3 info: title: ColdSend Public API description: >- Programmatic access to ColdSend for managing cold email campaigns and sender accounts. version: 1.0.0 contact: name: ColdSend Support email: support@coldsend.pro url: https://coldsend.pro servers: - url: https://api.coldsend.pro description: Production security: - ApiKeyAuth: [] paths: /api/public/v1/sender-accounts/quotas: get: tags: - Sender Accounts summary: Get per-inbox daily quotas for a campaign description: >- **Get live daily quota state for every inbox assigned to a campaign** Returns the effective daily send limit and current usage per inbox, combining the inbox-level hard cap, campaign override, ramp-up schedule, and the live Redis counter. Useful for building send-capacity dashboards or pre-flight checks before kicking off a campaign. operationId: get_sender_account_quotas_api_public_v1_sender_accounts_quotas_get parameters: - name: campaign_id in: query required: true schema: type: string format: uuid description: Campaign ID to retrieve inbox quotas for title: Campaign Id description: Campaign ID to retrieve inbox quotas for responses: '200': description: Quota data retrieved content: application/json: schema: $ref: '#/components/schemas/InboxQuotaListResponse' '401': description: Missing or invalid API key '403': description: Insufficient permissions – requires 'sender_accounts:read' scope '404': description: Campaign not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: InboxQuotaListResponse: properties: success: type: boolean title: Success message: type: string title: Message campaign_id: type: string format: uuid title: Campaign Id description: Campaign ID the quotas apply to date: type: string title: Date description: UTC date these counters apply to (YYYY-MM-DD). reset_at_utc: type: string format: date-time title: Reset At Utc description: Next UTC midnight when all counters reset. ramp_up_enabled: type: boolean title: Ramp Up Enabled description: Whether ramp-up is enabled for this campaign. default: false ramp_up_increment: type: integer title: Ramp Up Increment description: Emails/inbox/day added per ramp-up day. 0 when ramp-up is disabled. default: 0 ramp_up_max_limit: type: integer title: Ramp Up Max Limit description: Fully-ramped daily cap. 0 when ramp-up is disabled. default: 0 inboxes: items: $ref: '#/components/schemas/InboxQuotaItem' type: array title: Inboxes description: Per-inbox quota details, ordered by email_address. type: object required: - success - message - campaign_id - date - reset_at_utc title: InboxQuotaListResponse description: Response listing per-inbox daily quota state for a campaign. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError InboxQuotaItem: properties: inbox_id: type: string format: uuid title: Inbox Id description: Inbox ID email_address: type: string title: Email Address description: Inbox sending address inbox_daily_limit: type: integer title: Inbox Daily Limit description: >- Per-inbox daily send cap configured on the inbox (inboxes.daily_send_limit, default 50). campaign_daily_limit: type: integer nullable: true title: Campaign Daily Limit description: >- Per-campaign override ceiling (campaigns.daily_limit_per_inbox). Null when the campaign has not configured an override. effective_daily_limit: type: integer title: Effective Daily Limit description: >- The binding cap today: min(inbox_daily_limit, campaign_daily_limit). This is the number the UI should show as the denominator. effective_limit_source: type: string title: Effective Limit Source description: >- Which cap is binding today: 'campaign' when the campaign override is the tighter number, otherwise 'inbox'. inbox_usage_today: type: integer title: Inbox Usage Today description: Emails sent by this inbox across ALL campaigns today (UTC). campaign_usage_today: type: integer title: Campaign Usage Today description: >- Emails sent by this inbox for THIS campaign today (UTC). Only tracked when the campaign has a daily_limit_per_inbox configured; 0 otherwise. effective_remaining: type: integer title: Effective Remaining description: >- effective_daily_limit minus the relevant usage counter; never negative. is_rate_limited: type: boolean title: Is Rate Limited description: >- True when effective_remaining is 0 (the inbox cannot send another email for this campaign until the UTC reset). reset_at_utc: type: string format: date-time title: Reset At Utc description: Next midnight UTC when the daily counters roll over. ramp_up_current_day: type: integer nullable: true title: Ramp Up Current Day description: >- Current ramp-up day for this inbox (0=pending, 1..max_day). Null when ramp-up is not enabled for the campaign. ramp_up_daily_limit: type: integer nullable: true title: Ramp Up Daily Limit description: >- Effective ramp-up daily limit for this inbox today. Null when ramp-up is not enabled for the campaign. type: object required: - inbox_id - email_address - inbox_daily_limit - effective_daily_limit - effective_limit_source - inbox_usage_today - campaign_usage_today - effective_remaining - is_rate_limited - reset_at_utc title: InboxQuotaItem description: Per-inbox daily quota state for a single campaign. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key with format cs_live_xxx ````