<Intro>

<EndpointHeader />

<Description>

Returns configuration and verification events for a sending domain.

</Description>

</Intro>

<Parameters in="path">

<Parameter name="domain_id" type="string">

<Description>

Domain ID.

</Description>

</Parameter>

</Parameters>

<Parameters in="query">

<Parameter name="sort" type="string">

<Description>

Field to sort by.

</Description>

</Parameter>

<Parameter name="order" type="string">

<Description>

Sort direction. Defaults to `desc` (newest/largest first).

</Description>

</Parameter>

<Parameter name="limit" type="integer">

<Description>

Maximum number of items to return per page.

</Description>

</Parameter>

<Parameter name="starting_after" type="string">

<Description>

Cursor from the `next_cursor` field of a previous list response. Returns items immediately after the cursor position in the current sort order.

</Description>

</Parameter>

<Parameter name="ending_before" type="string">

<Description>

Cursor from the `prev_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order.

</Description>

</Parameter>

</Parameters>

<Payload kind="response">

<Field name="data" type="array of object" required>

<Description>

Page of domain events, newest first by default.

</Description>

<FieldChildren kind="response">

<Field name="id" type="string" prefix="data." required>

<Description>

Event ID.

</Description>

</Field>

<Field name="type" type="string" prefix="data." required>

<Description>

Type of domain event. Open enum — new event types may be added over time, so treat any unrecognized value as a future event rather than an error. The values below are the types known at this version.

</Description>

</Field>

<Field name="summary" type="string" prefix="data." required>

<Description>

Human-readable summary of what changed.

</Description>

</Field>

<Field name="metadata" type="object" prefix="data." required>

<Description>

Structured details for the event.

</Description>

</Field>

<Field name="created_at" type="string" prefix="data." required>

<Description>

When the event was recorded.

</Description>

</Field>

</FieldChildren>

</Field>

<Field name="next_cursor" type="nullable string" required>

<Description>

Cursor for the next page. Pass back as `starting_after` to advance forward. Null when no next page exists.

</Description>

</Field>

<Field name="prev_cursor" type="nullable string" required>

<Description>

Cursor for the previous page. Pass back as `ending_before` to step backward. Null when no previous page exists.

</Description>

</Field>

<Field name="refresh_cursor" type="nullable string" required>

<Description>

Refresh anchor. Pass back as `ending_before` later to fetch items that have appeared since this response. Non-null whenever `data` is non-empty; null only on an empty page. Distinct from `prev_cursor`.

</Description>

</Field>

</Payload>