---
title: "GET /v1/grants"
method: GET
path: "/v1/grants"
---

# GET /v1/grants

`GET /v1/grants`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-better-auth.session_token`

Every access edge in this organisation: which principal may reach which mailbox, and how.

## Response `200`

The request has succeeded.

- Grant[]
  - `id` string, required
  - `principalId` string, required
  - `mailboxId` string, required
  - `capabilities` string[], required
  - `createdAt` string, date-time, required

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/foundermail/apis/org.md) - [All operations](https://skmtc.dev/foundermail/apis/org/llms.txt) - [OpenAPI document](https://skmtc.dev/foundermail/apis/org/revisions/8bbb36e378ab?raw)