> 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.

# Get the catalog

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

Lists the kinds, part keys, part labels and models this deployment serves.

Reference: https://docs.blende.dev/api-reference/catalog/get-the-catalog

## 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

The kinds, part keys, part labels and models.

- `kinds` (list of enum, required) — Every kind the models emit.
  - 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`
- `part_keys` (list of enum, required) — The parts a policy may `keep`.
  - Allowed values: `person.given`, `person.surname`, `address.street`, `address.city`, `location.region`, `organization.legal_form`
- `part_labels` (list of enum, required) — The output vocabulary of `Part`.
  - Allowed values: `first_name`, `last_name`, `initials`, `suffix`, `placeholder`, `nickname`, `name_unclear`, `salutation`, `title`, `street`, `house_number`, `po_box`, `unit`, `postcode`, `district`, `city`, `region`, `country`, `landmark`, `address_unclear`, `natural_feature`, `location_unclear`, `org_name`, `legal_form`, `org_type`, `organization_unclear`
- `models` (list of CatalogModelsItems, required) — The models.

## 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

### CatalogModelsItems

A model and whether it is the default.

- `model` (enum, required) — The model.
  - Allowed values: `outis-flash-1`, `outis-1`
- `default` (boolean, required) — Whether it is the default.

### 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.

## Examples

**Response**

```json
{
  "kinds": [
    "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"
  ],
  "part_keys": [
    "person.given",
    "person.surname",
    "address.street",
    "address.city",
    "location.region",
    "organization.legal_form"
  ],
  "part_labels": [
    "first_name",
    "last_name",
    "initials",
    "suffix",
    "placeholder",
    "nickname",
    "name_unclear",
    "salutation",
    "title",
    "street",
    "house_number",
    "po_box",
    "unit",
    "postcode",
    "district",
    "city",
    "region",
    "country",
    "landmark",
    "address_unclear",
    "natural_feature",
    "location_unclear",
    "org_name",
    "legal_form",
    "org_type",
    "organization_unclear"
  ],
  "models": [
    {
      "model": "outis-flash-1",
      "default": true
    },
    {
      "model": "outis-1",
      "default": false
    }
  ]
}
```

**SDK Code**

```python The v1 catalog
import requests

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

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

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

print(response.json())
```

```javascript The v1 catalog
const url = 'https://api.blende.dev/api/v1/catalog';
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);
}
```