API & Integration

The Rewards API Built for Developers, Scale, and Speed

Catalog API is a modern, developer-friendly rewards and gift card API designed to power employee recognition, customer incentives, loyalty programs, and research rewards, at scale. With a single API integration, you gain access to millions of global rewards from multiple suppliers, without managing complex vendor relationships.

Catalog API adds rewards to the product you already run, an HR platform, loyalty app, survey tool, or enterprise system, so you can send them programmatically, securely, and reliably.

Read the API docs Get sandbox access

developers

</> Just want to build?

$ Skip the pitch. Read the API or spin up a sandbox in minutes.

Read the API docs Get sandbox access

Building with an agent? AI integration guide →

Start Building in Minutes

The same request, response, and render loop from start to finish. Each command uses YOUR_API_KEY and SOCKET_ID placeholders. Drop in your own account's key and sockets and run them as-is. The responses below are live from a demo US catalog socket.

1
Authenticate & verify

Your API key rides in the Authorization header as a Bearer credential on every call. Start with the health check to confirm you're connected. You get a key and a sandbox socket the moment you sign up.
terminal
```
$ curl "https://api.catalogapi.com/api/v2/ping" \
  -H "Authorization: Bearer YOUR_API_KEY"
```
Response (truncated)
```
{
  "status": "ok",
  "timestamp": "2026-10-07T20:34:20.848197Z",
  "version": "2.0.0"
}
```
Open this in the API docs →

Search the catalog

Ask a socket for its items. The same call powers filtering, paging, and search. Here it's the first page of a catalog.

terminal

$ curl "https://api.catalogapi.com/api/v2/sockets/SOCKET_ID/items?page=1&per_page=4" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (truncated)

{
  "items": [
    {
      "brand": "Fitbit",
      "catalog_item_id": 6485113,
      "fulfillment_type": "physical",
      "name": "Google Pixel Watch 2 4G LTE + Bluetooth (Hazel / Champagne Gold Aluminum)",
      "points": 43599
    },
    {
      "brand": "Oakley",
      "catalog_item_id": 5719989,
      "fulfillment_type": "physical",
      "name": "Oakley Polarized Leffingwell Sunglasses Prizm Black Polarized Matte Black Ink/Prizm Black Polarized Prizm Black Polarized",
      "points": 21010
    }
  ],
  "total_count": 23927
}

Render it however you like

Open this in the API docs →

3
Get an item's detail

Take any item id from the search response and pull its full detail (images, description, and options) to render a product view.
terminal
```
$ curl "https://api.catalogapi.com/api/v2/sockets/SOCKET_ID/items/ITEM_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```
Response (truncated)
```
{
  "availability": "Currently Available for Fulfillment",
  "brand": "Fitbit",
  "catalog_item_id": 6485113,
  "fulfillment_type": "physical",
  "has_description": true,
  "has_options": false,
  "is_limited_stock": false,
  "name": "Google Pixel Watch 2 4G LTE + Bluetooth (Hazel / Champagne Gold Aluminum)",
  "points": 43599
}
```
Render a product view

Google Pixel Watch 2 4G LTE + Bluetooth (Hazel / Champagne Gold Aluminum)
Fitbit

43599 loyalty points

Fulfillment: Physical

Currently Available for Fulfillment

Meet the Google Pixel Watch 2, engineered by Google with the best of Fitbit.1 Understand your health and fitness with Fitbit’s most advanced heart rate tracking.2 See the best of Google at a glance, including Gmail and Calendar, and get peace of mind from personal safety features.3 And keep going with even longer battery life.4 1 Works with most phones running Android 9.0 or newer. Requires a Google Account, Google Pixel Watch app and internet access. Paid subscription required for some features. See g.co/pixelwatch/specs for technical and device specifications. 2 Some features require Fitbit mobile app. Accuracy of heart rate tracking may be affected by physiology, location of device and your movements and activity. 3 Google apps and services are not available in all countries or languages. Data rates may apply. 4 Compared to 1st generation Google Pixel Watch.

Open this in the API docs →
4

Build a cart & place an order

Adding items to a cart and placing an order follows the same request/response shape. Try those endpoints live in the docs, or spin up a sandbox and build.

Try it in the API docs Get sandbox access

One Integration.
Multiple Suppliers.

No Vendor Management

Catalog API removes the complexity of managing multiple reward providers. With one integration, you gain access to:

Global and local merchandise brands
Visa® prepaid card options
Digital and physical gift cards
Travel and experience rewards

This unified approach reduces development time, minimizes maintenance, and future-proofs your platform as reward options expand.

Built for Existing Programs

Scale Without Rebuilding

Catalog API is widely used as a rewards integration for employee programs, incentive platforms, and loyalty systems.

Common technical use cases:

Trigger rewards from HRIS, CRM, or LMS systems
Automate incentives based on events or performance
Deliver rewards globally from a single codebase
Support high-volume campaigns without degradation

From hundreds of rewards to millions, Catalog API scales reliably, making it one of the best APIs for sending digital rewards at scale in the USA and beyond.

Already Have a Storefront?

You don't have to use our catalog and cart endpoints to build a shopping experience. Every catalog socket comes with a SQLite file of its catalog that you download and load into your own system, so your search, merchandising, and checkout stay yours. From there you place orders with a single call and follow fulfillment by tracking or webhooks.

That order call runs the same validations the cart flow does, including price and whether the item needs a shipping address, so a catalog snapshot that has drifted since you loaded it fails at order time rather than placing a wrong order. Read the fulfillment-only guide

Stop Polling for Order Status

We push you an event every time an order item changes status, so your system reacts as soon as something ships, backorders, or gets rejected. You don't have to poll on a timer or guess how often is often enough.

What you get:

Signed deliveries. Verify an HMAC-SHA256 signature, or use HTTP basic auth if you prefer. Credentials are stored encrypted.
A delivery log you can inspect. Failed deliveries are retried, then held so you can re-send them yourself once your endpoint is healthy.
A sandbox simulator, so you can exercise your handler before a real order exists.
Per-status, per-environment control. Choose which status changes fire, separately for sandbox and production.

Every event carries a stable id, so a handler that dedupes on it stays correct even if a delivery arrives twice. See the webhook documentation for the signature format and payload shape.

# POST to your endpoint

x-webhook-signature: v1=3f9a...

{
  "event": "order_item.status_changed",
  "status_change_id": "9f8c1a2b-...",
  "external_order_id": "your-ref-1",
  "line_item_id": "li-1",
  "status": "exported",
  "occurred_at": "2026-06-18T12:00:00Z"
}

Developer Tools &
Resources

Get Up and Running Fast

We provide everything developers need to integrate quickly and confidently.

Developer resources include:

Ask Your AI Assistant About Us

We run a public MCP server. Connect it and your assistant can check which countries we cover, look at real catalog items, and answer questions about how the integration works, using our data instead of guessing. It's read-only and needs no API key.

claude mcp add --transport http catalogapi https://api.catalogapi.com/mcp

For other clients, point them at https://api.catalogapi.com/mcp over streamable HTTP.

When Something Goes Wrong

Support is tiered. Your team fronts your own users, and anything to do with an order escalates to us. We work stuck and rejected items with the supplier directly, and come to you only when we need something from your end user, such as a corrected address.

When you onboard, we set your named contacts up in our ticketing system, so they raise issues with our team directly and can see progress on them, rather than emailing into a general queue. Response times are covered by your agreement. While you're still evaluating, technical questions go to support@catalogapi.com .

Flexible Catalog &
Fulfillment Options

Pre-Configured for Your Needs

Your catalog sockets are configured by our team to match your program requirements across regions, audiences, or use cases.

Available configurations include:

Country or region-specific catalog sockets
Reward value limits and rules
Digital and physical fulfillment options
Branded delivery and messaging

Delivered instantly digitally or shipped physically, fulfillment stays smooth and trackable.