---
title: "Get correspondent policy"
method: GET
path: "/v1/policy"
tags: ["policy"]
---

# Get correspondent policy

`GET /v1/policy`

## Request

- Base URL: `https://api.openmail.sh`
- URL: `https://api.openmail.sh/v1/policy`
- Auth: HTTP bearer

Read the correspondent policy for a scope (account by default, or a pod/inbox). Returns the mode this scope sets for each direction, the effective mode after inheritance, this scope's own rules, and the rules inherited from parent scopes. Inbox-scoped keys are rejected. A pod-scoped key may read its own pod or an inbox in that pod, never account-wide policy. Account-wide keys may read any scope.

## Query parameters

- `podId` string
- `inboxId` string

## Response `200`

The resolved policy for the scope

- object: The resolved policy for the scope

## Other responses

- `403`: The authenticating key is scoped and cannot read policy (`forbidden`)
- `404`: Pod or inbox not found

---

[API](https://skmtc.dev/openmail/apis/openmail-api.md) · [All operations](https://skmtc.dev/openmail/apis/openmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openmail/apis/openmail-api/revisions/b943eecca7e2?raw)