# Incentivio

> Incentivio is a Boston-based digital guest engagement platform for multi-unit restaurant brands, unifying branded online ordering, loyalty, gift cards, marketing automation and guest analytics. Incentivio publishes no public developer documentation, but two production services expose live, unauthenticated OpenAPI definitions on Incentivio's own hosts: a guest-facing Mobile & Ordering API (125 operations) and an operator-facing Admin API (421 operations). Both sit behind an OAuth 2.0 authorization server that publishes RFC 8414 metadata anonymously.

Generated by API Evangelist from probed and harvested artifacts. Incentivio does not publish an llms.txt of its own — https://incentivio.com/llms.txt and https://apidocs.incentivio.com/llms.txt both return 404.

## What an agent needs to know first

- Every call is scoped to a restaurant brand tenant. The mobile API takes a `CLIENTID` header; the admin API takes `Inc-Client-Id` (and sometimes `Inc-Merchant-Id`). Without it, endpoints return 400 or 500, not a useful message.
- Authentication is an OAuth 2.0 bearer token. Unauthenticated calls return `401` with `WWW-Authenticate: Bearer realm="restservice"`.
- Errors have an EMPTY BODY. The outcome is carried in the `incentivio-code` and `incentivio-message` response headers. Reading only the body tells you nothing.
- There are no rate-limit headers, no idempotency keys, and no declared 4xx/5xx responses in either definition. Payment operations are POST with no replay protection.
- There is no public sign-up. Access is arranged through partnership or enterprise onboarding.

## APIs

- [Mobile & Ordering API](https://mobile.incentivio.com/incentivio-mobile-api): guest-facing REST API behind order.incentivio.com. Catalogs and menus, locations and stores, orders and order items, payments and payment instruments, gift cards, wallets, loyalty accounts and points, offers and discounts, surveys, segments, messaging, user accounts. OpenAPI 3.0.1, 112 paths, 125 operations, 285 schemas.
- [Admin API](https://adminapi.incentivio.com/incentivio-admin-api): operator-facing REST API behind admin.incentivio.com. Client and merchant configuration, stores and locations, menu import and menu intelligence, campaigns and offer distribution, guest journeys and personas, segments and tags, loyalty administration, gift card issuance and ACH funding, payments, refunds, fund transfers, Spreedly connectors, role and module permissions, and a large CSV-capable reporting surface. OpenAPI 3.1.0, 327 paths, 421 operations, 621 schemas.

## Machine-readable contracts

- [Mobile OpenAPI (live)](https://mobile.incentivio.com/incentivio-mobile-api/v3/api-docs)
- [Admin OpenAPI (live)](https://adminapi.incentivio.com/incentivio-admin-api/v3/api-docs)
- [Mobile OAuth 2.0 Authorization Server Metadata](https://mobile.incentivio.com/incentivio-mobile-api/.well-known/oauth-authorization-server)
- [Admin OAuth 2.0 Authorization Server Metadata](https://adminapi.incentivio.com/incentivio-admin-api/.well-known/oauth-authorization-server)

Both OpenAPI definitions are springdoc auto-generations. They are structurally valid and semantically empty: no operation summaries, no descriptions, no examples, no securitySchemes, and success responses only.

## API Evangelist artifacts

- [Authentication profile](authentication/incentivio-authentication.yml)
- [API conventions](conventions/incentivio-conventions.yml)
- [Error catalog](errors/incentivio-error-codes.yml)
- [Data model](data-model/incentivio-data-model.yml)
- [Lifecycle](lifecycle/incentivio-lifecycle.yml)
- [Standards conformance](conformance/incentivio-conformance.yml)
- [Rate limits](rate-limits/incentivio-rate-limits.yml)
- [Plans and pricing](plans/incentivio-plans-pricing.yml)
- [Client packages](packages/incentivio-packages.yml)
- [Well-known probe](well-known/incentivio-well-known.yml)
- [Event surface](asyncapi/incentivio-webhooks.yml)
- [Candidate MCP tool surface](mcp/incentivio-mcp.yml)
- [Agent skills](skills/_index.yml)

## Company

- [Website](https://incentivio.com/)
- [Platform](https://incentivio.com/platform/)
- [Incentivio Connect](https://incentivio.com/feature/incentivio-connect/)
- [Integrations](https://incentivio.com/integrations/)
- [Developer portal](https://apidocs.incentivio.com/) — Theneo-hosted, zero published projects
- [Become a partner](https://incentivio.com/become-a-partner/)
- [Request a demo](https://incentivio.com/demo/)
- [Contact](https://incentivio.com/contact/)
- [Blog](https://incentivio.com/blog/)
- [Terms of use](https://incentivio.com/terms-of-use/)
- [Privacy policy](https://incentivio.com/privacy/)

## Optional

- [Admin console login](https://admin.incentivio.com/)
- [Guest ordering app](https://order.incentivio.com/)
- [Mobile service health](https://mobile.incentivio.com/incentivio-mobile-api/actuator/health)
- [Admin service health](https://adminapi.incentivio.com/incentivio-admin-api/actuator/health)