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-08-25T16:30:48.046421Z",
  "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": "Samsung",
      "catalog_item_id": 6517495,
      "fulfillment_type": "physical",
      "name": "Samsung - 43-inch Commercial 4K UHD Display, 500 NIT - Black",
      "points": 85266
    },
    {
      "brand": "Bose",
      "catalog_item_id": 11724398,
      "fulfillment_type": "physical",
      "name": "Bose SoundLink Plus Portable Speaker Black",
      "points": 30956
    }
  ],
  "total_count": 24152
}

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": "Available",
  "brand": "Samsung",
  "catalog_item_id": 6517495,
  "fulfillment_type": "physical",
  "has_description": true,
  "has_options": false,
  "is_limited_stock": false,
  "name": "Samsung - 43-inch Commercial 4K UHD Display, 500 NIT - Black",
  "points": 85266
}
```
Render a product view
43-inch Commercial 4K UHD Display, 500 NIT
Samsung

85266 loyalty points

Fulfillment: Physical

Available

Introducing the QMC series, the slimmest display in the Samsung’s UHD signage offerings. This products deliver an unparalleled slim design that fits into any business, while delivering the visual quality to make a big impact. The sleek form factor is easily installed to fit any room design and delivers stunning visual performance. Dynamic Crystal Color and Quantum Processor Lite 4K delivering consistent, lifelike colors to any content. This is not just a display for simple advertising. It’s a display that brings the solutions, tools, and picture quality to grow to your business, no matter what industry you’re in.
Features
Ultra Slim Depth The unparalleled ultra-slim thickness of 28.5mm makes it the thinnest option in Samsung's UHD Signage series. It comes with the Slim Fit Wall Mount, which allows you to install it neatly and easily in any environment.
Even Bezels and Centered VESA Holes The bezels are even on all four sides of the display for a consistent look, while the central VESA mounting holes ensure secure mounting and easy adjustability to portrait mode.
Dynamic Crystal Color One billion shades of color let you see every subtlety with lifelike color variations. Images are clear and consistent thanks to Samsung’s industry leading video processing and upscaling technology.
Smartview+ In the QMC series, SmartView+ enables wireless screen sharing for easy collaboration and quick screen switching with just a click
Smart Calibration Guarantee complete brand consistency across every location. Using the Samsung mobile app, calibrate displays to showcase brand logos and other collateral in the exact colors required.
Details
Brand: Samsung
Model Number: QM43C
Product Name: 43-inch Commercial 4K UHD Display, 500 NIT
Color: Black
Product Width: 38.169 inches
Display Type: LCD
Resolution: 4K (2160p)
Screen Size: 43 inches
Warranty - Parts: 3 years
Warranty - Labor: 3 years
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.