Unified Cache API

Overview

The Unified Cache API provides access to cached data from your connected accounts. Data is synchronized periodically, enabling fast bulk queries without hitting underlying service rate limits.

Base URL

https://api.usehandled.io/api/v1/ipaas/unified_cache

Authentication

All requests require a Bearer token:

Authorization: Bearer YOUR_API_TOKEN

Required Parameters

Parameter	Description
`integrated_account_id`	The connected account to query

Available Resources

The Unified Cache API supports the following commerce primitives:

Resource	Description
Orders	Customer purchases with line items, pricing, shipping, and financial data
Products	SKUs, descriptions, pricing, dimensions, and attributes
Inventory	Stock levels across warehouses and fulfillment centers
Customers	Buyer information, preferences, and purchase history
Fulfillment Orders	Order allocations to locations/fulfillment partners
Fulfillment Shipments	Shipping confirmations with carrier and tracking info
Returns	RMA requests flowing to warehouses for processing
Refunds	Approved refund records triggering credits
Trackings	Shipment tracking with carrier and delivery status

Example Request

curl 'https://api.usehandled.io/api/v1/ipaas/unified_cache/orders?integrated_account_id=ACCOUNT_ID&limit=100' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Example Response

{
  "result": [
    {
      "id": "order_123",
      "status": "pending",
      "line_items": [...],
      "shipping_address": {...},
      "created_at": "2024-01-15T10:30:00Z",
      "cached_at": "2024-01-15T11:00:00Z"
    }
  ],
  "next_cursor": "abc123"
}

Cache Freshness

The cached_at field indicates when the data was last synchronized. Set up sync jobs to control cache refresh frequency.

When to Use Cache API

Use Cached When

Bulk data operations
Historical analysis
Reducing API calls to underlying services
Working with rate-limited integrations

Use Realtime When

You need current data immediately
Building dashboards or reports
Single record lookups
Real-time order management

List Returns

​Overview

​Base URL

​Authentication

​Required Parameters

​Available Resources

​Example Request

​Example Response

​Cache Freshness

​When to Use Cache API

Use Cached When

Use Realtime When

Overview

Base URL

Authentication

Required Parameters

Available Resources

Example Request

Example Response

Cache Freshness

When to Use Cache API