# BitBadges Claims

Claims are BitBadges' universal off-chain gating primitive: **Meet criteria → Receive rewards.**

Claims are composed of plugins executed in a configurable pipeline. Built-in plugins handle common patterns (codes, passwords, address whitelists, token ownership). Custom plugins let you add any logic via HTTP endpoints.

## Pages

| Page                                                                    | Description                                                              |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [Overview](/for-developers/claims/overview.md)                          | How claims work, standard vs on-demand, supported plugins                |
| [Core Concepts](/for-developers/claims/concepts.md)                     | Claim numbers, success logic, sign-in, gating approvals, claim codes     |
| [Built-In Plugins](/for-developers/claims/built-in-plugins.md)          | Schemas and configuration for all core + pre-built plugins               |
| [Dynamic Stores](/for-developers/claims/dynamic-stores.md)              | BitBadges-hosted user lists for gating claims                            |
| [Custom Plugins](/for-developers/claims/custom-plugins.md)              | Build your own plugins with HTTP endpoints                               |
| [Gating On-Chain Approvals](/for-developers/claims/gating-approvals.md) | Hybrid off-chain/on-chain Merkle proof process, consistency requirements |
| [Security & Trust Assumptions](/for-developers/claims/security.md)      | Versioning, oracle trust, plugin risks, minimizing trust                 |
| [API Reference](/for-developers/claims/api-reference.md)                | Complete, fetch, simulate, and verify claims programmatically            |
| [Examples](/for-developers/claims/examples.md)                          | Full E2E claim configurations and completion snippets                    |
| [Designing Claims](/for-developers/claims/designing-claims.md)          | Criteria approaches, rewards, automation, and design tips                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bitbadges.io/for-developers/claims.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.