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

# invoice.voided

> Sent when an invoice is voided.

<Note>Available from API version `2026-05-27.curie` onwards.</Note>

Triggered when an invoice is voided. A voiding invoice is issued that offsets the original; its ID is provided as `voiding_invoice` in the context. Limited to `usage` and `prepayment` invoices.

## Response body parameters

<ResponseField name="id" type="string" required>
  Unique event identifier (starts with `evt_`).
</ResponseField>

<ResponseField name="timestamp" type="string" required>
  ISO 8601 timestamp when the event was created.
</ResponseField>

<ResponseField name="topic" type="literal" required>
  Always `invoice.voided` for this event.
</ResponseField>

<ResponseField name="context" type="object" required>
  Event-specific data containing related resource IDs.

  <Expandable title="properties" defaultOpen>
    <ResponseField name="invoice" type="string" required>
      ID of the original invoice that was voided (starts with `inv_`).
    </ResponseField>

    <ResponseField name="subscription" type="string" required>
      ID of the related subscription (starts with `sub_`).

      Fetch the full record via [`GET /subscriptions/{id}`](/api-reference/subscriptions/retrieve-a-subscription).
    </ResponseField>

    <ResponseField name="voiding_invoice" type="string" required>
      ID of the offsetting (Storno) invoice issued to reverse the original. References the original via the `voided_invoice` field on the invoice resource. Starts with `inv_`.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Example payload theme={null}
  {
    "id": "evt_mi4f0oda6x9m7gcsvjk0ole1",
    "timestamp": "2026-01-15T10:30:00.000Z",
    "topic": "invoice.voided",
    "context": {
      "invoice": "inv_mi4f0oda6x9m7gcsvjk0ole1",
      "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
      "voiding_invoice": "inv_mi4f0oda6x9m7gcsvjk0ole1"
    }
  }
  ```
</RequestExample>