Skip to main content
GET
/
api
/
campaigns
/
{id}
/
account-usage
Inspect sender account usage for a campaign
curl --request GET \
  --url https://app.puffle.ai/api/campaigns/{id}/account-usage \
  --header 'Authorization: Bearer <token>'
{ "accounts": [ { "account_id": "aaaa1111-1111-1111-1111-111111111111", "email": "[email protected]", "daily_limit": 50, "sent_today": 12, "status": "active" } ] }

​
Overview

Daily-scope view of every sender account attached to the campaign. For each sender, returns the account’s daily_limit (defaults to 30 when no override is set), the account’s status, and today’s sent count as reported by Instantly analytics. Pass a ?date=YYYY-MM-DD query param to query a specific day — otherwise the server uses today in UTC. Accounts not owned by the caller are filtered out silently — the endpoint only ever shows accounts belonging to the authenticated user. Instantly failures are swallowed: the account list still comes back, and affected rows have sent_today: 0.

​
AI agent notes

Timezone. The date query param respects the caller’s timezone. Always pass an explicit YYYY-MM-DD when the UI is surfacing “today” to a user outside UTC — otherwise the server compares against UTC midnight and may show stale counts around the day boundary.Not a rate-limit source of truth. This endpoint is a daily-scope projection. For weekly rolling limits and per-campaign attribution, use GET /api/campaigns/{id}/senders — it queries account_daily_stats directly and returns weekly totals.Related endpoints. Pair with listCampaignSenders when building the pre-launch sender dashboard — usage + weekly limits together explain throttling behavior.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Campaign UUID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Query Parameters

​
date
string

ISO date (YYYY-MM-DD) to query analytics for. Respects the caller's timezone. Defaults to today in UTC when omitted or malformed.

Pattern: ^\d{4}-\d{2}-\d{2}$

Response

Sender accounts with their daily limit and today's send count.

Per-sender daily-limit view for a campaign.

​
accounts
object[]
required

One row per sender account attached to the campaign and owned by the caller. Empty array if the campaign has no senders.