> ## 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.created

> Sent when an invoice transitions to `open`.

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

Triggered when an invoice transitions to the `open` status, i.e. it has been finalized and is now awaiting payment. Limited to `usage` and `prepayment` invoices. Use this to record the new invoice in your own systems before payment is attempted.

## 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.created` 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 related invoice (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>
  </Expandable>
</ResponseField>

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