---
title: "Read Inbox"
method: GET
path: "/intake"
tags: ["intake"]
---

# Read Inbox

`GET /intake`

## Request

- Base URL: `https://api.seal.net` (the document declares no server; this is the origin it was published from)
- URL: `https://api.seal.net/intake`
- Auth: none declared

## Query parameters

- `to` string, required: The address whose inbox to read.
- `wait` integer
- `seen` string, nullable: `version` of the last answer.
- `all` boolean: Owner copies and cards too (a person's inbox).

## Response `200`

Successful Response

- InboxList
  - `items` InboxItem[], required
    - `id` string, required: `s.<seal>.<code>` a delivery, `o.<seal>` an owner copy, `r.<id>` a card.
    - `item` 'delivery' | 'owner' | 'request', required
    - `path` string, required: `/s/{seal}/{code}`, `/s/{seal}` or `/i/{id}` on seal.net, without a fragment.
    - `fragment` string, nullable, required: The link's or the owner blob's key wrapped to this address's bundle (sealed box v2); null for a card.
    - `label` string, nullable, required
    - `sender` string, nullable, required: The sender's address when it proved it, else null.
    - `at` string, date-time, required
    - `expires_at` string, date-time, required
    - `what` string, nullable: A card: what is asked for.
    - `kind` string, nullable: A card: the request kind.
    - `recipient_bundle` string, nullable: A card: the bundle the answer is sealed to.
  - `version` string, required: Pass as `seen` to wait for a change; opaque.
  - `now` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seal/apis/seal-api.md) · [All operations](https://skmtc.dev/seal/apis/seal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seal/apis/seal-api/revisions/68460cfa1957?raw)
