---
updatedAt: 2026-08-18T22:07:21.000Z
agentTools:
  projectIndex: https://docs.delivr.ai/llms.txt
---

# Get daily billing usage by meter

Returns your organization's billable usage as one entry per (day, meter) cell — the data behind the usage trend chart in the dashboard. Days with no usage for a meter are omitted; treat missing cells as zero.

Window semantics match the by-meter rollup: month-grained snapping, defaulting to the current month. Read-only, never metered.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Account",
    "description": "Manage your own organization with the organization API key: validate a key and discover its scope (`whoami`), read or update your organization's profile, read your billing usage (period summary, per-meter rollup, daily trend), and estimate what a quantity would cost at your rates this billing period. Creating organizations,\nprojects, and pixels and managing members use the **Platform Management** (Partner) API.\n\n**Authentication:** organization API key (`X-Api-Key` + `X-Api-Secret`).\n\n**Base URL:** `https://api.delivr.ai`\n",
    "version": "1.0",
    "contact": {
      "name": "Delivr.ai Support",
      "url": "https://delivr.ai"
    }
  },
  "servers": [
    {
      "url": "https://api.delivr.ai",
      "description": "Production"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": [],
      "ApiSecretAuth": []
    }
  ],
  "tags": [
    {
      "name": "Billing",
      "description": "Read your organization's billing usage: period summaries, the per-meter rollup, and the daily trend. These report usage volume, not charges. All reads are scoped to the key's own organization and are free (never metered)."
    }
  ],
  "paths": {
    "/api/v1/billing/usage/daily-by-meter": {
      "get": {
        "operationId": "getBillingUsageDailyByMeter",
        "tags": [
          "Billing"
        ],
        "summary": "Get daily billing usage by meter",
        "description": "Returns your organization's billable usage as one entry per (day, meter) cell — the data behind the usage trend chart in the dashboard. Days with no usage for a meter are omitted; treat missing cells as zero.\n\nWindow semantics match the by-meter rollup: month-grained snapping, defaulting to the current month. Read-only, never metered.\n",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Window start (YYYY-MM-DD, UTC), snapped to the first of its month. Defaults to the first of the current month."
          },
          {
            "name": "end_date",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Window end (YYYY-MM-DD, UTC); the full month containing this date is included. Defaults to the current month."
          }
        ],
        "responses": {
          "200": {
            "description": "Per-day, per-meter usage for the window.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BillingDailyByMeterResponse"
                }
              }
            }
          },
          "400": {
            "description": "Malformed or inverted date range."
          },
          "401": {
            "description": "Missing or invalid API key / secret."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Organization API key (`dlvr_` prefixed), created in the dashboard at `https://app.delivr.ai/{org_id}/settings/api-keys`. Must be paired with the `X-Api-Secret` header."
      },
      "ApiSecretAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Secret",
        "description": "Secret half of the organization API key, paired with `X-Api-Key`. Both headers are required on every request."
      }
    },
    "schemas": {
      "BillingDailyByMeterEntry": {
        "type": "object",
        "required": [
          "date",
          "meter",
          "quantity",
          "event_count"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "meter": {
            "type": "string",
            "description": "The billable SKU (same values as the by-meter rollup)."
          },
          "quantity": {
            "type": "integer",
            "format": "int64"
          },
          "event_count": {
            "type": "integer",
            "format": "int64",
            "description": "How many billed actions make up the quantity: API requests, export runs and audience downloads. An API request that returns records from several projects counts once per project. Not pixel events."
          }
        }
      },
      "BillingDailyByMeterResponse": {
        "type": "object",
        "required": [
          "period_start",
          "period_end",
          "entries"
        ],
        "properties": {
          "period_start": {
            "type": "string",
            "format": "date"
          },
          "period_end": {
            "type": "string",
            "format": "date",
            "description": "Exclusive end of the month-snapped window."
          },
          "entries": {
            "type": "array",
            "description": "One entry per (day, meter) with usage. Missing cells mean zero.",
            "items": {
              "$ref": "#/components/schemas/BillingDailyByMeterEntry"
            }
          }
        }
      }
    }
  }
}
```