# Blend Partner API

> Sell tickets to Blend events inside your own app. Your users browse a curated
> catalog in a webview, pick seats, and pay on YOUR payment rail. Blend owns
> inventory, ticket issuance and entry; you own the customer and the money.

Base URL: https://api.blendapp.ai/api/v1
Auth: every request sends `x-blend-key` and `x-blend-secret` headers.
Credentials are issued by email and never appear in this documentation.

Full text in one file: https://apidocs.blendapp.ai/apidocs/llms-full.txt

## Documentation

- [Overview](https://apidocs.blendapp.ai/apidocs): What the Blend Partner API is and the five-step lifecycle.
- [Quickstart](https://apidocs.blendapp.ai/apidocs/quickstart): A working integration end to end, in build order.
- [How the integration works](https://apidocs.blendapp.ai/apidocs/how-it-works): Architecture, ownership, and failure handling in plain language.
- [Authentication](https://apidocs.blendapp.ai/apidocs/authentication): Keys, secrets, HMAC signatures, scopes, IP allowlisting.
- [Any backend](https://apidocs.blendapp.ai/apidocs/server): Signing samples for .NET, Java, Node, Python, PHP, Go and Ruby, plus a test vector.
- [Listing events](https://apidocs.blendapp.ai/apidocs/events): GET /v1/channel/events, the partner catalog and its filters.
- [Event detail & tickets](https://apidocs.blendapp.ai/apidocs/event-detail): GET /v1/channel/events/:id, full event payload.
- [Which events you see](https://apidocs.blendapp.ai/apidocs/curation): How a Blend admin decides your catalog.
- [Buyer sessions](https://apidocs.blendapp.ai/apidocs/sessions): POST /v1/channel/session, the one-time webview URL.
- [Inventory & seat holds](https://apidocs.blendapp.ai/apidocs/holds): The atomic oversell guard, seat hold TTLs, Redis fast path.
- [Reserving an order](https://apidocs.blendapp.ai/apidocs/checkout): Quote, reserve, idempotency keys, capacity errors.
- [Taking the payment](https://apidocs.blendapp.ai/apidocs/pay): The native bridge on iOS and Android, and its trust model.
- [Confirming & settlement](https://apidocs.blendapp.ai/apidocs/confirm): Signed confirmation, retries, refunds, settlement.
- [Native UI (no webview)](https://apidocs.blendapp.ai/apidocs/native): Render your own screens and drive them with the Blend API directly.
- [Embedding the webview](https://apidocs.blendapp.ai/apidocs/webview): Webview requirements common to every platform.
- [iOS (Swift)](https://apidocs.blendapp.ai/apidocs/ios): A complete WKWebView view controller with the pay bridge.
- [Android (Kotlin)](https://apidocs.blendapp.ai/apidocs/android): A complete WebView activity with the pay bridge.
- [React Native](https://apidocs.blendapp.ai/apidocs/react-native): A complete react-native-webview component.
- [Errors](https://apidocs.blendapp.ai/apidocs/errors): Every error code and the correct response to each.
- [Rate limits](https://apidocs.blendapp.ai/apidocs/rate-limits): Per-minute limits on every endpoint.
- [Testing & go-live](https://apidocs.blendapp.ai/apidocs/testing): How to verify before launch, and the sign-off checklist.