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-07T20:01:32.422651Z",
  "version": "2.0.0"
}
```
Open this in the API docs →
2
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": "Tumi",
      "catalog_item_id": 5496790,
      "fulfillment_type": "physical",
      "name": "Alpha Bravo Search Backpack Black",
      "points": 63280
    },
    {
      "brand": "Therabody",
      "catalog_item_id": 5399008,
      "fulfillment_type": "physical",
      "name": "Therabody Wave Solo Black",
      "points": 10900
    }
  ],
  "total_count": 25389
}
```
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": "Tumi",
  "catalog_item_id": 5496790,
  "fulfillment_type": "physical",
  "has_description": true,
  "has_options": false,
  "is_limited_stock": false,
  "name": "Alpha Bravo Search Backpack Black",
  "points": 63280
}
```
Render a product view
Alpha Bravo Search Backpack Black
Tumi

63280 loyalty points

Fulfillment: Physical

Currently Available for Fulfillment

Modern and versatile this generously sized backpack is ideal for daily commutes to work or school and for travels that take you farther. Whatever you need pack it all and carry it in comfort.
The Search backpack is modern and versatile for daily commutes
Zip entry to main compartment reveals a padded tablet pocket
Padded laptop pocket fits up to 15" laptops
Interior has card pockets media pockets and zip pockets
Padded mesh back panel
Daisy chains on front/shoulder straps
Front zip pocket
2 Side zip pockets (one with water resistant lining)
Side open pocket
Top carry handle with leather accent
Add-a-Bag sleeve fits over luggage handles for easier traveling
TUMI Tracer program - helps reunite customers with lost or stolen luggage
Made of durable Ballistic Nylon material
Dimensions: 14"W x 17"H x 8.3"D
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.

API & Integration

Start Building in Minutes

Authenticate & verify

Search the catalog

Get an item's detail

Build a cart & place an order

One Integration.Multiple Suppliers.