---
search:
  tags:
    - Inboxes
    - GET
seo:
  description: >-
    BillionSend extension: the event stream of one inbox, as GET… Reference for
    the GET /inboxes/{inbox_id}/events endpoint in the BillionSend API.
sidebar:
  label: Stream one inbox's events
  badge: GET
title: Stream one inbox's events
type: openapi-operation
---
BillionSend extension: the event stream of one inbox, as GET /inboxes/events, ending when the inbox is deleted or expires; it carries inbox.deleted and inbox.expired whatever types names. An inbox-scoped key may stream its own inbox, without the events about held mail.

`GET /inboxes/{inbox_id}/events`

**Responses**

- `200` — An event stream that stays open. A client that reconnects with Last-Event-ID gets the events it missed (up to 24 hours back, then a stream.gap event) before the live ones
- `401` — Missing, malformed, unknown or revoked API key
- `403` — An agent naming an event about held mail
- `404` — Not found
- `422` — Validation error
- `429` — Too many streams open, or the rate limit (rate\_limit\_exceeded, with Retry-After)

Response example, 200:

```json
"string"
```
