---
title: "GrantRef"
description: "a grant as a caller sees it, after the three narrowings"
section: concepts
address: /concepts/grantref
contract: 0476e35e6e275db5
---

# GrantRef

a grant as a caller sees it, after the three narrowings

[figure: GrantRef is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | people |



## Fields


| field | type | required | note |
|---|---|---|---|
| `grant` | `id` | yes |  |
| `mode` | `one of read only \| propose \| act \| full autonomy` | yes |  |
| `permissions` | [Permission](/concepts/permission) | yes |  |
| `where` | [Scope](/concepts/scope) | yes |  |
| `data_group` | `text` | no | the data group the grant names, whose members are the only units the call may touch (test 2) |
| `limits` | [GrantLimits](/concepts/grantlimits) | no | the limits left on the grant: its budget, its rate, the voices and the sending identities it names (test 5) |
| `ends_at` | `time` | no | when the grant ends; a call after it is not allowed (test 5) |



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