> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get ingested data over time

> Returns total and premium ingested bytes for the current team, one point per ingestion day. Snapshots only include ingestion volume starting October 1, 2026. startDate is a required inclusive UTC ISO 8601 date-time string, endDate is an optional inclusive UTC ISO 8601 date-time string that defaults to now, and the range can be at most one year. Byte values are int64 values encoded as strings.



## OpenAPI

````yaml https://api.wirespeed.co/v1/openapi.json get /v1/billing/data-usage-over-time
openapi: 3.0.0
info:
  title: Wirespeed API
  description: The public Wirespeed API. v1 is the first stable contract.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.wirespeed.co
security: []
tags: []
paths:
  /v1/billing/data-usage-over-time:
    get:
      tags:
        - Billing
      summary: Get ingested data over time
      description: >-
        Returns total and premium ingested bytes for the current team, one point
        per ingestion day. Snapshots only include ingestion volume starting
        October 1, 2026. startDate is a required inclusive UTC ISO 8601
        date-time string, endDate is an optional inclusive UTC ISO 8601
        date-time string that defaults to now, and the range can be at most one
        year. Byte values are int64 values encoded as strings.
      operationId: BillingController_getDataUsageOverTime
      parameters:
        - name: startDate
          required: true
          in: query
          description: Start date (inclusive, ISO8601 string)
          schema:
            type: string
        - name: endDate
          required: false
          in: query
          description: End date (inclusive, ISO8601 string); defaults to now
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BillingDataUsagePointDto'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpError'
      security:
        - bearer: []
components:
  schemas:
    BillingDataUsagePointDto:
      type: object
      properties:
        date:
          type: string
          format: date-time
          description: Start of the UTC day the data was ingested (ISO8601)
        premiumIngestedBytes:
          type: string
          format: int64
          nullable: true
          description: Premium ingested data in bytes
        ingestedBytes:
          type: string
          format: int64
          nullable: true
          description: Total ingested data in bytes
      required:
        - date
        - premiumIngestedBytes
        - ingestedBytes
    HttpError:
      type: object
      properties:
        message:
          type: string
        statusCode:
          type: number
        code:
          type: string
          description: >-
            Stable machine-readable error code. Clients should branch and
            translate on this instead of `message`.
        params:
          type: object
          description: Values interpolated into the message for `code`.
          additionalProperties:
            oneOf:
              - type: string
              - type: number
              - type: boolean
            nullable: true
        validationErrors:
          description: >-
            Per-property failures when `code` is `VALIDATION_FAILED` from
            request validation.
          type: array
          items:
            $ref: '#/components/schemas/HttpValidationIssue'
      required:
        - message
        - statusCode
    HttpValidationIssue:
      type: object
      properties:
        property:
          type: string
          description: Dotted path of the invalid property.
        constraint:
          type: string
          description: >-
            class-validator constraint name; clients translate
            `errors:validation.<constraint>`.
        params:
          type: object
          description: Values interpolated into the constraint message.
          additionalProperties:
            oneOf:
              - type: string
              - type: number
              - type: boolean
            nullable: true
        code:
          type: string
          description: Catalog code overriding the constraint translation.
      required:
        - property
        - constraint
        - params
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API key
      type: http
      description: >-
        Team API key sent as a Bearer token. Create a key in Wirespeed under
        Settings → Team. See
        https://docs.wirespeed.co/api-reference/authentication.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.