---
title: "Membership"
description: "a user in a tenant, as a member or a guest"
section: concepts
address: /concepts/membership
contract: 0476e35e6e275db5
---

# Membership

a user in a tenant, as a member or a guest

[figure: Membership is a definition at tenant scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | definition |
| scope | tenant |
| key | the user and the tenant |
| store | postgres |
| family | people |



## Fields


| field | type | required | note |
|---|---|---|---|
| `user` | `id` | yes |  |
| `tenant` | `id` | yes |  |
| `kind` | `one of member \| guest` | yes | a guest's home tenant is another one |
| `state` | [Readiness](/concepts/readiness) | yes |  |



## Routes that use it
- [`/v1/act/membership`](/reference/act/membership) returns it