> ## 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 Event

Reports usage events with optional dimensions for granular tracking.

## Mutation

<CodeGroup>
  ```graphql Mutation theme={null}
  mutation ReportEvent($input: UsageEventsReportInput!) {
    reportEvent(events: $input)
  }
  ```

  ```json Variables theme={null}
  {
    "input": {
      "events": [
        {
          "customerId": "customer-123",
          "eventName": "api_call",
          "timestamp": "2024-01-15T10:30:00Z",
          "dimensions": {
            "endpoint": "/api/v1/users",
            "method": "GET",
            "status": "200"
          }
        },
        {
          "customerId": "customer-123",
          "eventName": "api_call",
          "timestamp": "2024-01-15T10:31:00Z",
          "dimensions": {
            "endpoint": "/api/v1/orders",
            "method": "POST",
            "status": "201"
          }
        }
      ]
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "reportEvent": null
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="input" type="UsageEventsReportInput" required>
  Input for reporting events

  <Expandable title="properties">
    <ParamField body="events" type="[UsageEventInput]" required>
      Array of events to report

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

        <ParamField body="eventName" type="String" required>
          Name of the event
        </ParamField>

        <ParamField body="timestamp" type="DateTime">
          When event occurred (defaults to now)
        </ParamField>

        <ParamField body="dimensions" type="JSON">
          Event dimensions/properties
        </ParamField>

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

        <ParamField body="idempotencyKey" type="String">
          Deduplication key
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Common Use Cases

<AccordionGroup>
  <Accordion title="Granular API tracking">
    Track API calls with endpoint and method dimensions.
  </Accordion>

  <Accordion title="Feature usage analytics">
    Track which features customers use most.
  </Accordion>

  <Accordion title="Multi-dimension billing">
    Bill based on specific event properties.
  </Accordion>
</AccordionGroup>

## Related Operations

* [Report Usage](/api-and-sdks/api-reference/mutations/report-usage) - Simple usage reporting