# CatalogAPI

> Global rewards and gift card API. Browse a catalog of over two million gift cards, prepaid cards, and merchandise across 120+ countries, build a cart, place an order, and track fulfillment through one integration.

Every page below serves markdown to a request that sends
`Accept: text/markdown`.

## Start here

- [API documentation](https://api.catalogapi.com/api/docs): Every endpoint, parameter, and model, across catalogs, carts, orders, and fulfillment. Ask for markdown and this index links a separate page per endpoint, model, and guide, so you can fetch the one operation you need instead of the whole API.
- [Authentication](https://api.catalogapi.com/auth.md): API keys, not OAuth. A person creates the key; an agent cannot mint one.
- [AI agent integration guide](https://api.catalogapi.com/developers/ai-agents): First call in minutes: copy-paste curl, and a prompt that scaffolds an integration.
- [Pricing](https://api.catalogapi.com/pricing): Pay on redemption. No monthly fee and no long-term commitment.

## Ask us directly

An assistant can query the live catalog instead of reading about it.

- [MCP server card](https://api.catalogapi.com/.well-known/mcp/server-card.json): Read-only MCP server at /mcp (streamable-http, no API key). Tools: check_coverage, search_rewards, get_reward_details, how_it_works. Registered as com.catalogapi/catalogapi.

## Machine-readable

- [OpenAPI description](https://api.catalogapi.com/api/v2/openapi-clean): OpenAPI 3.1. Production and sandbox servers, ready for code generation.
- [API catalog](https://api.catalogapi.com/.well-known/api-catalog): RFC 9727 linkset naming every document on this page. Also advertised in a Link header on every public page.
- [Agentic resource catalog](https://api.catalogapi.com/.well-known/ai-catalog.json): Agentic Resource Discovery catalog. The MCP server, agent skills, and REST API, each typed by media type for a registry to index.
- [AI context](https://api.catalogapi.com/api/v2/.well-known/ai-context): Capabilities, common workflows, error codes, and rate limits as JSON.
- [Agent skills](https://api.catalogapi.com/.well-known/agent-skills/index.json): Six task-shaped skills generated from the live documentation, each with a digest of the bytes served.
- [Protected resource metadata](https://api.catalogapi.com/.well-known/oauth-protected-resource): RFC 9728. Names no authorization server, because none can issue a token for this API.

## What it does

- [Features](https://api.catalogapi.com/features): Catalog, cart, ordering, fulfillment, webhooks, and multi-currency support.
- [Applications](https://api.catalogapi.com/applications): Reward programs this is built for: market research, health and wellness, sales incentives, loyalty, recognition.
- [Global coverage](https://api.catalogapi.com/international): Countries served, local currencies, and how fulfillment works outside the US.
- [Security and compliance](https://api.catalogapi.com/security): SOC 2 Type II, GDPR, HIPAA, and CCPA.
- [Support](https://api.catalogapi.com/faq): Operational answers the endpoint reference does not give: order statuses, cart validation, key rotation, escalation.

## Optional

Background rather than reference.

- [About](https://api.catalogapi.com/about): Who runs CatalogAPI, and who uses it.
- [Privacy policy](https://api.catalogapi.com/privacy): How data is handled.