> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.blende.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.blende.dev/_mcp/server.

# List policies

GET https://api.blende.dev/api/v1/policies

Lists the built-in policies, then the key's saved ones.

Reference: https://docs.blende.dev/api-reference/policies/list-policies

## Authentication

- `Authorization` header (bearer token, required) — An API key: `Authorization: Bearer bl_live_…`.
- `Authorization` header (bearer token, required) — Blende's apps: a sign-in JWT, sent with `Blende-Context-Key`.

## Response

### 200

Every policy, built-ins first.

- `policies` (list of StoredPolicy, required) — The built-ins first, then the saved ones.

## Errors

### 401 Unauthorized Error

`unauthenticated`, `key_expired`.

- `type` (string, required) — `https://blende.dev/errors/<code>`.
- `title` (string, required) — A short summary of the code.
- `status` (integer, required) — The HTTP status.
- `code` (enum, required) — The stable error code.
  - Allowed values: `invalid_request`, `invalid_context_key`, `invalid_rule`, `invalid_pattern`, `too_many_patterns`, `too_many_matches`, `unauthenticated`, `key_expired`, `quota_exceeded`, `insufficient_scope`, `context_key_mismatch`, `policy_read_only`, `not_found`, `policy_not_found`, `text_too_large`, `unsupported_media_type`, `rate_limited`, `internal`, `model_busy`, `store_full`
- `request_id` (string, required) — The request's id, also in the `Request-Id` header.
- `detail` (string, optional) — What went wrong; never echoes input.
- `errors` (list of ProblemErrorsItems, optional) — Field errors, each pointing to a field of the schema.

### 429 Too Many Requests Error

`rate_limited`.

- `type` (string, required) — `https://blende.dev/errors/<code>`.
- `title` (string, required) — A short summary of the code.
- `status` (integer, required) — The HTTP status.
- `code` (enum, required) — The stable error code.
  - Allowed values: `invalid_request`, `invalid_context_key`, `invalid_rule`, `invalid_pattern`, `too_many_patterns`, `too_many_matches`, `unauthenticated`, `key_expired`, `quota_exceeded`, `insufficient_scope`, `context_key_mismatch`, `policy_read_only`, `not_found`, `policy_not_found`, `text_too_large`, `unsupported_media_type`, `rate_limited`, `internal`, `model_busy`, `store_full`
- `request_id` (string, required) — The request's id, also in the `Request-Id` header.
- `detail` (string, optional) — What went wrong; never echoes input.
- `errors` (list of ProblemErrorsItems, optional) — Field errors, each pointing to a field of the schema.

### 500 Internal Server Error

`internal`.

- `type` (string, required) — `https://blende.dev/errors/<code>`.
- `title` (string, required) — A short summary of the code.
- `status` (integer, required) — The HTTP status.
- `code` (enum, required) — The stable error code.
  - Allowed values: `invalid_request`, `invalid_context_key`, `invalid_rule`, `invalid_pattern`, `too_many_patterns`, `too_many_matches`, `unauthenticated`, `key_expired`, `quota_exceeded`, `insufficient_scope`, `context_key_mismatch`, `policy_read_only`, `not_found`, `policy_not_found`, `text_too_large`, `unsupported_media_type`, `rate_limited`, `internal`, `model_busy`, `store_full`
- `request_id` (string, required) — The request's id, also in the `Request-Id` header.
- `detail` (string, optional) — What went wrong; never echoes input.
- `errors` (list of ProblemErrorsItems, optional) — Field errors, each pointing to a field of the schema.

## Types

### StoredPolicy

A built-in or saved policy.

- `id` (StoredPolicyId, required) — A built-in's name or a saved policy's `pol_…` id.
- `name` (string, required) — Your label; a built-in's is its id.
- `policy` (FullPolicy, required) — Every field filled in.
- `created_at` (datetime, required, nullable) — RFC 3339; `null` for a built-in.
- `updated_at` (datetime, required, nullable) — RFC 3339; `null` for a built-in.

### ProblemErrorsItems

One field error.

- `pointer` (string, required) — The schema field, e.g. `#/redaction_policy/overrides/0/match/pattern`.
- `detail` (string, required) — What is wrong with it.

### StoredPolicyId

A built-in's name or a saved policy's `pol_…` id.

- DefaultPolicy: enum
  - Allowed values: `standard`, `strict`, `light`
- PolicyId: string

### FullPolicy

A policy with every field filled in.

- `detect` (list of enum, required) — The kinds to find; by default all but `date` and `product_name`.
  - Allowed values: `person`, `username`, `location`, `organization`, `occupation`, `address`, `email`, `phone`, `ip`, `iban`, `fax`, `url`, `date`, `date_of_birth`, `age`, `credit_card`, `card_expiry`, `card_security_code`, `tax_id`, `social_security`, `health_insurance`, `passport`, `id_card`, `customer_number`, `password`, `pin`, `api_key`, `delivery_number`, `order_number`, `invoice_number`, `case_number`, `product_number`, `price`, `salary`, `balance`, `bank_account`, `driving_licence`, `vehicle_plate`, `employee_number`, `student_number`, `coordinates`, `nationality`, `gender`, `file_path`, `other_number`, `product_name`
- `keep` (list of enum, required) — Parts shown in clear; by default `address.city` and `location.region`.
  - Allowed values: `person.given`, `person.surname`, `address.street`, `address.city`, `location.region`, `organization.legal_form`
- `sensitivity` (enum, required) — How sure the model must be to hide; default `normal`.
  - Allowed values: `normal`, `max`
- `model` (enum, required) — The model that detects; default `outis-flash-1`.
  - Allowed values: `outis-flash-1`, `outis-1`
- `replace` (enum, required) — `tag` (default) writes a restorable `[PERSON_7K2QX9MB]`; `kind` writes `[PERSON]`, irreversibly.
  - Allowed values: `tag`, `kind`
- `overrides` (list of Rule, required) — Rules that hide or leave by tag, pattern or range and beat the model; at most 50 patterns.

### Rule

One override; range beats tag beats pattern, and at a tie the later rule wins.

- `action` (enum, required) — Hide or leave what matches.
  - Allowed values: `hide`, `leave`
- `match` (Match, required) — What the rule matches.
- `kind` (RuleKind, optional) — The kind for a hide by pattern or range; default `custom`.

### Match

A tag, a pattern or a range, told apart by their key.

- TagMatch: TagMatch
- PatternMatch: PatternMatch
- RangeMatch: RangeMatch

### RuleKind

The kind for a hide by pattern or range; default `custom`.

- Kind: enum
  - Allowed values: `person`, `username`, `location`, `organization`, `occupation`, `address`, `email`, `phone`, `ip`, `iban`, `fax`, `url`, `date`, `date_of_birth`, `age`, `credit_card`, `card_expiry`, `card_security_code`, `tax_id`, `social_security`, `health_insurance`, `passport`, `id_card`, `customer_number`, `password`, `pin`, `api_key`, `delivery_number`, `order_number`, `invoice_number`, `case_number`, `product_number`, `price`, `salary`, `balance`, `bank_account`, `driving_licence`, `vehicle_plate`, `employee_number`, `student_number`, `coordinates`, `nationality`, `gender`, `file_path`, `other_number`, `product_name`
- enum
  - Allowed values: `custom`

### TagMatch

Every occurrence of an issued tag's value; inline policies only.

- `tag` (string, required) — An issued tag, e.g. `[PERSON_7K2QX9MB]`.

### PatternMatch

Every match of an RE2 pattern of at most 200 code points, without backreferences or lookaround.

- `pattern` (string, required) — The RE2 pattern; never logged.
- `flags` (enum, optional) — `i`: case-insensitive. The only flag.
  - Allowed values: `i`

### RangeMatch

One occurrence in this request's text; inline policies only.

- `range` (Range, required) — The occurrence in this request's text.

### Range

A half-open `[start, end)` range in code points of the text as sent.

- `start` (integer, required) — The first code point, inclusive.
- `end` (integer, required) — The code point after the last, exclusive.

## Examples

**Response**

```json
{
  "policies": [
    {
      "id": "standard",
      "name": "standard",
      "policy": {
        "detect": [
          "person",
          "username",
          "location",
          "organization",
          "occupation",
          "address",
          "email",
          "phone",
          "ip",
          "iban",
          "fax",
          "url",
          "date_of_birth",
          "age",
          "credit_card",
          "card_expiry",
          "card_security_code",
          "tax_id",
          "social_security",
          "health_insurance",
          "passport",
          "id_card",
          "customer_number",
          "password",
          "pin",
          "api_key",
          "delivery_number",
          "order_number",
          "invoice_number",
          "case_number",
          "product_number",
          "price",
          "salary",
          "balance",
          "bank_account",
          "driving_licence",
          "vehicle_plate",
          "employee_number",
          "student_number",
          "coordinates",
          "nationality",
          "gender",
          "file_path",
          "other_number"
        ],
        "keep": [
          "address.city",
          "location.region"
        ],
        "sensitivity": "normal",
        "model": "outis-flash-1",
        "replace": "tag",
        "overrides": []
      },
      "created_at": null,
      "updated_at": null
    },
    {
      "id": "strict",
      "name": "strict",
      "policy": {
        "detect": [
          "person",
          "username",
          "location",
          "organization",
          "occupation",
          "address",
          "email",
          "phone",
          "ip",
          "iban",
          "fax",
          "url",
          "date",
          "date_of_birth",
          "age",
          "credit_card",
          "card_expiry",
          "card_security_code",
          "tax_id",
          "social_security",
          "health_insurance",
          "passport",
          "id_card",
          "customer_number",
          "password",
          "pin",
          "api_key",
          "delivery_number",
          "order_number",
          "invoice_number",
          "case_number",
          "product_number",
          "price",
          "salary",
          "balance",
          "bank_account",
          "driving_licence",
          "vehicle_plate",
          "employee_number",
          "student_number",
          "coordinates",
          "nationality",
          "gender",
          "file_path",
          "other_number",
          "product_name"
        ],
        "keep": [],
        "sensitivity": "max",
        "model": "outis-flash-1",
        "replace": "tag",
        "overrides": []
      },
      "created_at": null,
      "updated_at": null
    },
    {
      "id": "light",
      "name": "light",
      "policy": {
        "detect": [
          "person",
          "username",
          "email",
          "phone",
          "ip",
          "iban",
          "fax",
          "url",
          "age",
          "credit_card",
          "card_expiry",
          "card_security_code",
          "tax_id",
          "social_security",
          "health_insurance",
          "passport",
          "id_card",
          "customer_number",
          "password",
          "pin",
          "api_key",
          "delivery_number",
          "order_number",
          "invoice_number",
          "case_number",
          "product_number",
          "bank_account",
          "driving_licence",
          "vehicle_plate",
          "employee_number",
          "student_number",
          "nationality",
          "gender",
          "file_path",
          "other_number"
        ],
        "keep": [],
        "sensitivity": "normal",
        "model": "outis-flash-1",
        "replace": "tag",
        "overrides": []
      },
      "created_at": null,
      "updated_at": null
    },
    {
      "id": "pol_4Tz9Kq2M",
      "name": "Case files",
      "policy": {
        "detect": [
          "person",
          "username",
          "location",
          "organization",
          "occupation",
          "address",
          "email",
          "phone",
          "ip",
          "iban",
          "fax",
          "url",
          "date_of_birth",
          "age",
          "credit_card",
          "card_expiry",
          "card_security_code",
          "tax_id",
          "social_security",
          "health_insurance",
          "passport",
          "id_card",
          "customer_number",
          "password",
          "pin",
          "api_key",
          "delivery_number",
          "order_number",
          "invoice_number",
          "case_number",
          "product_number",
          "price",
          "salary",
          "balance",
          "bank_account",
          "driving_licence",
          "vehicle_plate",
          "employee_number",
          "student_number",
          "coordinates",
          "nationality",
          "gender",
          "file_path",
          "other_number"
        ],
        "keep": [
          "address.city",
          "location.region"
        ],
        "sensitivity": "normal",
        "model": "outis-flash-1",
        "replace": "tag",
        "overrides": [
          {
            "action": "hide",
            "match": {
              "pattern": "AZ-\\d{4}-[A-Z]",
              "tag": "[PERSON_7K2QX9MB]"
            },
            "kind": "case_number"
          }
        ]
      },
      "created_at": "2026-11-21T09:30:00Z",
      "updated_at": "2026-11-21T09:30:00Z"
    }
  ]
}
```

**SDK Code**

```python The built-ins and one saved policy
import requests

url = "https://api.blende.dev/api/v1/policies"

headers = {"Authorization": "Bearer <apiKey>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript The built-ins and one saved policy
const url = 'https://api.blende.dev/api/v1/policies';
const options = {method: 'GET', headers: {Authorization: 'Bearer <apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```