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

# Report Usage Bulk

Reports usage for multiple customers/features in a single request.

## Mutation

<CodeGroup>
  ```graphql Mutation theme={null}
  mutation ReportUsageBulk($input: ReportUsageBulkInput!) {
    reportUsageBulk(input: $input) {
      measurementId
      currentUsage
    }
  }
  ```

  ```json Variables theme={null}
  {
    "input": {
      "usages": [
        {
          "customerId": "customer-123",
          "featureId": "feature-api-calls",
          "value": 100
        },
        {
          "customerId": "customer-456",
          "featureId": "feature-api-calls",
          "value": 250
        },
        {
          "customerId": "customer-789",
          "featureId": "feature-storage",
          "value": 1.5,
          "updateBehavior": "SET"
        }
      ]
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "reportUsageBulk": [
        {
          "measurementId": "measure-001",
          "currentUsage": 4632
        },
        {
          "measurementId": "measure-002",
          "currentUsage": 1250
        },
        {
          "measurementId": "measure-003",
          "currentUsage": 1.5
        }
      ]
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="input" type="ReportUsageBulkInput" required>
  Input for bulk usage reporting

  <Expandable title="properties">
    <ParamField body="usages" type="[UsageInput]" required>
      Array of usage reports

      <Expandable title="nested properties">
        <ParamField body="customerId" type="String" required>
          Customer reference ID
        </ParamField>

        <ParamField body="featureId" type="String" required>
          Feature reference ID
        </ParamField>

        <ParamField body="value" type="Float" required>
          Usage value
        </ParamField>

        <ParamField body="resourceId" type="String">
          Resource ID
        </ParamField>

        <ParamField body="updateBehavior" type="UsageUpdateBehavior">
          DELTA or SET
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="environmentId" type="UUID">
      Environment ID
    </ParamField>
  </Expandable>
</ParamField>

## Return Type

Returns an array of `UsageMeasurementWithCurrentUsage` objects.

## Common Use Cases

<AccordionGroup>
  <Accordion title="Batch processing">
    Report accumulated usage from a background job.
  </Accordion>

  <Accordion title="Periodic sync">
    Sync usage data from external systems.
  </Accordion>
</AccordionGroup>

## Related Operations

* [Report Usage](/api-and-sdks/api-reference/mutations/report-usage) - Single report
* [Report Event](/api-and-sdks/api-reference/mutations/report-event) - Event-based reporting