---
title: "Validate a Bre-B key"
method: GET
path: "/api/utilities/validations/bre-b"
tags: ["Utilities"]
---

# Validate a Bre-B key

`GET /api/utilities/validations/bre-b`

Validate a Bre-B key and return linked holder information if found.

## Query parameters

- `keyValue` string, required

## Response `200`

Validation result: success with holder details when key is found, or failure when not found

- union
  - BreBValidationSuccess
    - `holderIdNumber` string, required — Identification number of the key holder
    - `holderName` string, required — Name of the key holder
    - `type` 'success', required
  - BreBValidationFailure
    - `type` 'failure', required

## Other responses

- `401` — Unauthorized
- `403` — SignedAgreementRequiredException
- `503` — Key validation is temporarily unavailable. Please try again later.

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/versions/437d277f5948/schema)