# TrafficEvent

The TrafficEvent type of the TypeScript SDK, which domains.listEvents take or answer.

```ts
type TrafficEvent = {
  attempt: number | null
  blobHash: string | null
  deliveryId: string | null
  detail: string | null
  envelopeFrom: string | null
  envelopeTo: string | null
  eventTime: number
  mailboxId: string | null
  matchedBy: string | null
  messageId: string | null
  messageIdHeader: string | null
  originalAddress: string | null
  outcome: string
  response: string | null
  routeKind: string | null
  routeTarget: string | null
  size: number | null
  source: string
  subject: string | null
  template: TrafficEventTemplate | null
}
```

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `attempt` | `number` \| `null` | Delivery retry attempt number, or null |
| `blobHash` | `string` \| `null` | Storage blob SHA-256 hash, or null |
| `deliveryId` | `string` \| `null` | Delivery ID identifier, or null |
| `detail` | `string` \| `null` | Diagnostic detail or error message, or null |
| `envelopeFrom` | `string` \| `null` | SMTP envelope sender address, or null |
| `envelopeTo` | `string` \| `null` | SMTP envelope recipient address, or null |
| `eventTime` | `number` | Event timestamp in epoch seconds |
| `mailboxId` | `string` \| `null` | Associated mailbox ULID, or null |
| `matchedBy` | `string` \| `null` | Route ID or rule that handled the message, or null |
| `messageId` | `string` \| `null` | Internal message ULID, or null |
| `messageIdHeader` | `string` \| `null` | RFC 5322 Message-ID header, or null |
| `originalAddress` | `string` \| `null` | Original recipient before alias expansion, or null |
| `outcome` | `string` | Result outcome ('delivered', 'rejected', 'tempfail', 'bounced') |
| `response` | `string` \| `null` | Remote SMTP server response line, or null |
| `routeKind` | `string` \| `null` | Route kind ('mailbox', 'forward', 'pipe', 'discard'), or null |
| `routeTarget` | `string` \| `null` | Route target destination address or mailbox ID, or null |
| `size` | `number` \| `null` | Message size in bytes, or null |
| `source` | `string` | Event source component ('inbound', 'outbound', 'relay', 'imap') |
| `subject` | `string` \| `null` | Message subject line, or null |
| `template` | [`TrafficEventTemplate`](/docs/sdks/typescript/types/traffic-event-template) \| `null` | The prepared email this message was sent from, or null for any other mail. Present on each recipient's admission row and on every relay attempt after it; filter on it with `template`. |

## Used by

| Method | What it does |
| --- | --- |
| [`domains.listEvents`](/docs/sdks/typescript/domains/list-events) | Query domain delivery event log |

## Used in

[`AccountTrafficEvent`](/docs/sdks/typescript/types/account-traffic-event), [`DomainEvents`](/docs/sdks/typescript/types/domain-events).
