---
title: "StatedNumber"
description: "one number a buyer stated about itself, within its driver's bounds, under the consent ground the surface stated; never edited, a later statement is a later fact"
section: concepts
address: /concepts/statednumber
contract: 0476e35e6e275db5
---

# StatedNumber

one number a buyer stated about itself, within its driver's bounds, under the consent ground the surface stated; never edited, a later statement is a later fact

[figure: StatedNumber is a fact at brand scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | fact |
| scope | brand |
| key | its subject, its driver and its time |
| store | postgres+lake |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `subject` | [UnitRef](/concepts/unitref) | yes | an entity, a lead, or an anonymous session on a public page |
| `driver` | [KindOfMeasure](/concepts/kindofmeasure) | yes |  |
| `value` | `json` | yes |  |
| `dimension` | `text` | yes |  |
| `stated_through` | `one of a page \| a call \| a form \| a capture` | yes |  |
| `consent_ground` | `text` | yes | the ground under which it is kept |
| `retention_class` | [RetentionClass](/concepts/retentionclass) | no | for a stranger's number: the class whose clock erases it |



## Routes that use it
No route takes or returns StatedNumber directly. The record holds it, and the objects that point at it reach it.