# Yutai docs

The developer docs of Yutai, the loyalty network for tokenized equity: how a wallet, exchange or broker integrates, the SDK's elements and the distributor API's calls.

- [Quickstart](https://yutai.com/docs/quickstart.md): The four steps that carry a distributor from nothing to one wallet's holdings and benefits on its own page, using only these docs.
- [Get started](https://yutai.com/docs/get-started.md): The path to a first call: what to send an operator, the owner approval, the one-time collect inside its window, the key's shape and the scopes a key may carry.
- [Identifiers](https://yutai.com/docs/identifiers.md): How Yutai writes chains, instruments, companies' shares, wallet addresses, quantities, instants and its prefixed ids, read from its own rules.
- [Overview](https://yutai.com/docs.md): The three ways a distributor connects to Yutai and the kinds of distributor it serves, each way's state read from the tree when the site is built.
- [Verify a credential](https://yutai.com/docs/verify-credential.md): How a distributor checks a holder's Yutai credential in its own browser: paste it, and the page says whether it is valid, with no call to Yutai.
- [Link a customer account](https://yutai.com/docs/account-link.md): How a custodial distributor ties one of its customer accounts to one Yutai holder: the signed link grant, the message it carries, its account reference rule and its window.
- [Webhooks](https://yutai.com/docs/webhooks.md): What Yutai's webhooks send: the kinds of change they tell a distributor about, what one delivery carries, the delivery rules, the retry schedule and the signature header.
- [Sign a balance statement](https://yutai.com/docs/balance-statement.md): How a custodial distributor signs the balance statement Yutai stores as its attestation: the two kinds of statement, what one payload carries, the exact message to sign, the freshness window and the Ed25519 signature.
- [Credential card](https://yutai.com/docs/credential-card.md): How a distributor embeds Yutai's credential card: the served embed script, a live sample, and the attributes and tokens the element takes.
- [Benefits list](https://yutai.com/docs/benefits-list.md): How a distributor embeds Yutai's benefits list: the served embed script, a live sample, the benefits attribute and its row fields, and the claim event.
- [Benefits module](https://yutai.com/docs/benefits-module.md): How a distributor embeds Yutai's benefits module: the served embed script, the one element, and its two doors - the wallets attribute whose ask rides the page's connected client, and the answer attribute the module draws without asking anyone.
- [Tier badge](https://yutai.com/docs/tier-badge.md): How a distributor embeds Yutai's tier badge: the served embed script, a live sample per tier, the badge's two draws and the sentence it refuses with.
- [React](https://yutai.com/docs/react.md): How a distributor's React page renders Yutai's components: the props each component takes, and the samples the wrapper renders with their own code.
- [API reference](https://yutai.com/docs/api.md): Every call the distributor API serves, read from its interface description: the key it presents, the limits it takes and the one error shape a refusal answers.
- [Read the benefits one or more wallets reach](https://yutai.com/docs/api/getWalletEligibility.md): One call of the distributor API: GET /v1/eligibility, read from its interface description.
- [Read the benefits one or more instruments carry](https://yutai.com/docs/api/getBenefitAvailability.md): One call of the distributor API: GET /v1/availability, read from its interface description.
- [Read the companies one registry holds](https://yutai.com/docs/api/listRegistryCompanies.md): One call of the distributor API: GET /v1/registry/companies, read from its interface description.
- [Read the facts of one or more listed instruments](https://yutai.com/docs/api/readRegistryInstrumentFacts.md): One call of the distributor API: GET /v1/registry/instruments, read from its interface description.
- [Read one claim this distributor recorded](https://yutai.com/docs/api/getClaim.md): One call of the distributor API: GET /v1/claims/{id}, read from its interface description.
- [Reissue the redemption link of one claim this distributor recorded](https://yutai.com/docs/api/reissueClaimLink.md): One call of the distributor API: POST /v1/claims/{id}/link, read from its interface description.
- [Check the API status](https://yutai.com/docs/api/getApiStatus.md): One call of the distributor API: GET /v1/status, read from its interface description.
- [Ask for the challenge a wallet signs to claim a benefit](https://yutai.com/docs/api/requestClaimChallenge.md): One call of the distributor API: POST /v1/claims/challenge, read from its interface description.
- [Record a claim a wallet's own signature or a distributor's signed statement stands behind](https://yutai.com/docs/api/recordClaim.md): One call of the distributor API: POST /v1/claims, read from its interface description.
- [List the fulfilments waiting on this distributor](https://yutai.com/docs/api/listPendingFulfilments.md): One call of the distributor API: GET /v1/fulfilments, read from its interface description.
- [Confirm one fulfilment waiting on this distributor](https://yutai.com/docs/api/confirmFulfilment.md): One call of the distributor API: POST /v1/fulfilments/{id}/confirm, read from its interface description.
- [Create a Connect session](https://yutai.com/docs/api/createConnectSession.md): One call of the distributor API: POST /v1/connect/sessions, read from its interface description.
- [Read a Connect session](https://yutai.com/docs/api/getConnectSession.md): One call of the distributor API: GET /v1/connect/sessions/{id}, read from its interface description.
- [Example wallet](https://yutai.com/docs/examples/wallet.md): A working wallet integration: the code the example runs, and what the live distributor API answered for one wallet, or the one reason it read nothing.
- [Example exchange](https://yutai.com/docs/examples/exchange.md): A working exchange integration: the code the example runs, and what the live distributor API answered for one exchange's stock pages, or the one reason it read nothing.
- [Security](https://yutai.com/docs/security.md): The content security policy a distributor page's embed needs and the pin that binds the script to the bytes Yutai's build measured, read from that build.
- [Errors and limits](https://yutai.com/docs/errors.md): Every refusal the distributor API's calls share: one row per status code in the interface description's own words, with the calls that answer it, and the count each scope allows per key in one minute.
- [Changelog](https://yutai.com/docs/changelog.md): What changed in Yutai's distributor API, the distributor SDK and these docs since a distributor integrated, newest first.