---
title: "Canonical disclaimer registry"
method: GET
path: "/api/disclaimers"
tags: ["disclaimers"]
---

# Canonical disclaimer registry

`GET /api/disclaimers`

## Request

- Base URL: `https://api.halalterminal.com`
- URL: `https://api.halalterminal.com/api/disclaimers`
- Auth: none required

Return every disclaimer the API may attach to a response, keyed by
stable ID, so a client can render the long-form text or translate it
locally instead of embedding copies. No API key required.

## Response `200`

Every disclaimer the API may attach to a response, keyed by stable ID. Use this to render long-form text or translate disclaimers client-side.

- DisclaimersResponse
  - `disclaimers` Disclaimer[], required
    - `id` string, required: Stable category identifier — safe for clients to dedupe and cache on.
    - `version` string, required: ISO-8601 date of the most recent edit to `text`. Advances whenever the wording changes, even for typo fixes.
    - `lang` string: BCP-47 language tag for `text`. Today always 'en'; reserved for future i18n.
    - `severity` string, required: Grouping hint for UIs. 'religious' for fatwa/scholar caveats; 'data' for data-freshness, sourcing, or coverage caveats.
    - `text` string, required: Short inline disclaimer text.
    - `url` string, required: Canonical legal page URL (deep-linked to the relevant section).
  - `total` integer, required: Number of disclaimers in the registry.

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)