# list-entity-documents

Free; owner-only. Metadata for every document held for the entity — formation filings, registered-agent mail including service of process, EIN letters, certificates. Works in **every** lifecycle state including `dissolved` and `released`. Content is a separate call: `download-entity-document`.

This lists metadata for supplier-delivered documents; it does not provide OCR text, answer mail, or request physical forwarding. The registered-agent service includes five ordinary-mail scans per service year. Additional supplier mail charges are separate from this free listing and are not paid automatically. The service overview explains limits and time-sensitive requests for originals.

## Input

| Field | Required | Notes |
|---|---|---|
| `entity` | one of | Handle, e.g. `"US-WY:daski-labs-llc"`. |
| `assetId` | one of | Immutable UUID — disambiguates re-formed names. |
| `since` | no | ISO 8601 timestamp; only documents received after it. Handy for "any new mail since last week?". |

## Example

```jsonc
{
  "entity": "US-WY:daski-labs-llc",
  "since": "2026-09-01T00:00:00Z"     // omit for the full history
}
```

Fully idempotent — poll it as often as you like; pair `since` with your last check to watch for new registered-agent mail.

## Result artifact — `entity_documents`

```jsonc
{
  "entity": "US-WY:daski-labs-llc",
  "assetId": "5f0c2f6a-…",
  "documents": [
    {
      "documentId": "d3a19c40-…",        // Daski's id, stable — supplier ids are never exposed
      "title": "Articles of Organization",
      "type": "Formation Document",
      "source": "generated",
      "receivedAt": "2026-07-04T18:22:00.000Z",
      "pages": 2,
      "paymentLocked": false
    },
    {
      "documentId": "9b7e5512-…",
      "title": "Service of Process — Civil Summons",
      "type": "Hand delivered service of process",
      "source": "hand-delivered",
      "receivedAt": "2026-09-30T15:04:00.000Z",
      "pages": 6,
      "paymentLocked": true               // arrived while no RA service was active
    }
  ]
}
```

`type` and `source` preserve supplier values; they are not a Daski-normalized taxonomy.

## `paymentLocked`

Documents that arrived while no registered-agent service was active (i.e. after the post-expiry grace ran out and the entity went `ra_cancelled`) are locked at the supplier. They still appear here so you know they exist, but `download-entity-document` refuses them with an explanation. Unlocking is an **operator-mediated, billable action** — never automatic; contact support (`formation@sandbox-agent.bluetgroup.com`).

## Failure modes

- Invalid `since` (not ISO 8601): `invalid_since` — the message echoes what was received.
- Unknown `entity` / `assetId`, or not owned by the calling agent: `not_found`.

## Next step

`download-entity-document` with a `documentId` from this listing.

Document metadata also returns `mailCategory` (`ordinary`, `state_legal`, `other`
or `unknown`), the classification policy version, verified service-term dates
when available, and a support route with the entity/document reference. Supplier type
and source remain unchanged. Metadata refreshes can unlock a document without
duplicating the scan or its notification. Locks never trigger automatic payment.
Unavailable `source`, `pages`, policy/term dates and `originalRequestDeadline`
are omitted. Known zero page counts remain zero; `paymentLocked` and
`mailCategory` always describe access and classification independently.