Campaign spend

Request

curl "https://www.ugc.run/api/metrics/daily-spend?start=2026-09-01&end=2026-09-30" \
  --header "Authorization: Bearer $UGC_API_KEY"

Query parameters

Use valid calendar dates with start on or before end. Omit either bound to leave that side open. Without bounds, the response covers all available ledger periods.

How spend is calculated

Creator amounts are summed for each payment-ledger period. The total is divided evenly across that period’s inclusive calendar days. This is an allocation of ledger amounts, not a record of cash leaving your account on each day.

The days array is clipped to your requested date range. The periods array retains the full totals for overlapping periods. Dates without a ledger period are omitted; missing ledger data is not an estimate of zero spend.

Amounts use the project’s reporting currency and are rounded to two decimal places. Adding rounded daily values may differ slightly from the period total. Meta ad spend and subscription billing charges are not included.

Response

Example response for start=2026-09-01&end=2026-09-02. The full period total remains $3,000 while days contains only the two requested dates.

{
  "project": "studio",
  "currency": "USD",
  "method": "monthly_ledger_spread_flat",
  "days": [
    {
      "date": "2026-09-01",
      "spend": 100,
      "period_label": "September 2026"
    },
    {
      "date": "2026-09-02",
      "spend": 100,
      "period_label": "September 2026"
    }
  ],
  "periods": [
    {
      "period_start": "2026-09-01",
      "period_end": "2026-09-30",
      "period_label": "September 2026",
      "total": 3000,
      "num_days": 30,
      "daily": 100
    }
  ]
}