---
title: "ServiceNote"
description: "the short-lived signed token the API gateway hands the role behind it: who is calling, for which service, until when"
section: concepts
address: /concepts/servicenote
contract: 0476e35e6e275db5
---

# ServiceNote

the short-lived signed token the API gateway hands the role behind it: who is calling, for which service, until when

[figure: ServiceNote 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 | network |



## Fields


| field | type | required | note |
|---|---|---|---|
| `caller` | [Caller](/concepts/caller) | yes |  |
| `audience` | `text` | yes | the one service it is made out to |
| `issued_at` | `time` | yes |  |
| `expires_at` | `time` | yes | seconds, never minutes |
| `signature` | `hash` | yes |  |



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