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

# subscription.confirmed

> Sent when a customer's supply start date is confirmed.

Triggered once the signup process completes: the previous supplier has been cancelled and the grid operator has confirmed the supply start date. Can trigger more than once per subscription if the start date later changes, so make handlers idempotent on subscription ID and current start date.

## 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 `subscription.confirmed` for this event.
</ResponseField>

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

  <Expandable title="properties" defaultOpen>
    <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_abc123def456ghi789jkl012",
    "timestamp": "2026-01-15T10:30:00.000Z",
    "topic": "subscription.confirmed",
    "context": {
      "subscription": "sub_abc123def456ghi789jkl012"
    }
  }
  ```
</RequestExample>