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-05T17:17:54.164760Z",
  "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": "Igloo",
      "catalog_item_id": 6421890,
      "fulfillment_type": "physical",
      "name": "Trailmate Journey 70qt Wheeled Cooler Bone",
      "points": 62378
    },
    {
      "brand": "Cleveland Golf",
      "catalog_item_id": 12466274,
      "fulfillment_type": "physical",
      "name": "Cleveland CBZ Tour Satin Wedge Right Right",
      "points": 18312
    }
  ],
  "total_count": 24031
}

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": "Item is currently available",
  "brand": "Igloo",
  "catalog_item_id": 6421890,
  "fulfillment_type": "physical",
  "has_description": true,
  "has_options": false,
  "is_limited_stock": false,
  "name": "Trailmate Journey 70qt Wheeled Cooler Bone",
  "points": 62378
}
```
Render a product view
Trailmate Journey 70qt Wheeled Cooler Bone
Igloo

62378 loyalty points

Fulfillment: Physical

Item is currently available

With Trailmate® nothing gets in fun’s way. We built our up-for-anything cooler so it’ll roll right over rough terrain like it’s on a paved path. It’s loaded with tons of handy features — all-terrain smooth-ride wheels telescoping handle THERMECOOL™ insulation bottle openers dry storage and way more — so you can easily get to your destination and supply all things cool throughout the adventure.
Tackle sand & other challenging terrain with the superior traction & ground clearance of 10-inch never-flat smooth-ride wheels
Pull your load 50% easier thanks to the comfort & leverage of our horizontal dual-trigger steel Glide™ handle that has locking & telescoping functions
Innovative THERMECOOL™ foam insulation for advanced ice retention
Cool Riser Technology® improves cooling performance by elevating cooler body away from hot surfaces
Tie-down hooks (using bungee cords or rope not included) give you more carry options making it easy to haul things like towels quad chairs or a surfboard to your destination
Lockable water-resistant storage compartment features an anti-leak gasket to keep pocket-sized essentials (like your phone or sunglasses) handy & dry
Threaded drain plug is garden-hose compatible & features a non-slip easy-grip tethered cap
Removable butler tray placed on the telescoping handle provides an ideal space for serving food & drinks (& stores away under the lid when not in use)
Suspended interior food basket keeps selected food items dry
Exterior storage pocket holds items like sunscreen bug spray or a book
Two pole slots hold beach umbrellas or fishing rods
Dedicated slot in lid holds your mobile device upright where you can easily view it
Four self-draining cup holders in the lid keep your drinks secure & within reach
Two built-in stainless steel bottle openers help you quickly & easily enjoy your bottled beverages
Skid rails feature rust-resistant coating
Enjoy durability down to the details with premium stainless steel rust-resistant screws
Spacious 70-quart capacity fits up to 112 cans
Interior dimensions: 23"L x 13.5"W x 15"H
Exterior dimensions: 33.82"L x 20.31"W x 23.62"H
Weight: 34.7lbs/15.74kgs
Igloo 1-year limited warranty
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.