> ## 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 daily send usage for all sender accounts

> **Get today's email send usage for every inbox in your workspace**

Returns live per-inbox counters showing how many emails have been sent today
(UTC) and how many remain until the daily limit is reached.

Useful for monitoring sending health and detecting rate-limited inboxes.



## OpenAPI

````yaml /public_openapi.json get /api/public/v1/sender-accounts/daily-usage
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/daily-usage:
    get:
      tags:
        - Sender Accounts
      summary: Get daily send usage for all sender accounts
      description: >-
        **Get today's email send usage for every inbox in your workspace**


        Returns live per-inbox counters showing how many emails have been sent
        today

        (UTC) and how many remain until the daily limit is reached.


        Useful for monitoring sending health and detecting rate-limited inboxes.
      operationId: >-
        get_sender_accounts_daily_usage_api_public_v1_sender_accounts_daily_usage_get
      responses:
        '200':
          description: Daily usage data retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InboxDailyUsageResponse'
        '401':
          description: Missing or invalid API key
        '403':
          description: Insufficient permissions – requires 'sender_accounts:read' scope
components:
  schemas:
    InboxDailyUsageResponse:
      properties:
        success:
          type: boolean
          title: Success
        message:
          type: string
          title: Message
        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.
        inboxes:
          items:
            $ref: '#/components/schemas/InboxDailyUsageItem'
          type: array
          title: Inboxes
          description: Per-inbox usage details, ordered by email_address.
      type: object
      required:
        - success
        - message
        - date
        - reset_at_utc
      title: InboxDailyUsageResponse
      description: Response listing per-inbox daily usage for every inbox in a team.
    InboxDailyUsageItem:
      properties:
        inbox_id:
          type: string
          format: uuid
          title: Inbox Id
          description: Inbox ID
        email_address:
          type: string
          title: Email Address
          description: Inbox sending address
        daily_limit:
          type: integer
          title: Daily Limit
          description: Per-inbox daily send cap (inboxes.daily_send_limit, default 50).
        sent_today:
          type: integer
          title: Sent Today
          description: Emails sent by this inbox today (UTC).
        remaining:
          type: integer
          title: Remaining
          description: Remaining sends today; never negative.
        is_rate_limited:
          type: boolean
          title: Is Rate Limited
          description: True when remaining is 0 (inbox cannot send until UTC reset).
        reset_at_utc:
          type: string
          format: date-time
          title: Reset At Utc
          description: Next midnight UTC when the daily counter rolls over.
      type: object
      required:
        - inbox_id
        - email_address
        - daily_limit
        - sent_today
        - remaining
        - is_rate_limited
        - reset_at_utc
      title: InboxDailyUsageItem
      description: Per-inbox daily usage for the email-accounts page (no campaign context).
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key with format cs_live_xxx

````