# Collection.queried

URL: /business/events/Collection.queried · Id: `event:Collection.queried`

> Emitted each time a Collection is queried.

[Collection.query](/business/nouns/collection/query) emits `Collection.queried` when it completes on a [Collection](/business/nouns/collection).

| Property | Value |
| --- | --- |
| Emitted by | [Collection.query](/business/nouns/collection/query) |
| Noun | [Collection](/business/nouns/collection) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Collection.query](/business/nouns/collection/query) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Collection.queried`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.rows` | `json` | Yes | The matching records. |
| `data.collection` | [Collection](/business/nouns/collection) | Yes | The Collection the query read. |
| `data.collection.id` | `string` | Yes | The stable identifier, which never changes. |
| `data.collection.type` | list of [Noun](/business/nouns/noun) | Yes | The Nouns this Thing is an instance of. |
| `data.collection.state` | `string` | No | The current state in its lifecycle. |
| `data.collection.outside` | `json` | No | The ids this Thing has in outside tools, one per Integration, so a re-run matches instead of duplicating. |
| `data.collection.query` | `json` | No | The saved query that defines a dynamic Collection. |

### Example
```json
{
  "$id": "https://api.sb/kilnbakery.com/events/event_1",
  "$type": "Event",
  "name": "Collection.queried",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "rows": {},
    "collection": {
      "$id": "https://api.sb/kilnbakery.com/collections/collection_1",
      "$type": "Collection",
      "id": "Example id",
      "type": [
        "noun_1"
      ],
      "state": "Example state",
      "outside": {},
      "query": {}
    }
  },
  "seq": 1
}
```