KSS Data

Your data,
structured
and accessible.

Programmatic access to your KSS data — inventory, orders, pricing, purchases, and more — scoped to your account and ready to connect to any system you run.

Request Access Explore features →
GET /api/v1/products
// Response
{
  "Data": [
    {
      "ProductID": 10482,
      "ProductName": "Terra Bites Dark Choc",
      "State": "CA",
      "StatusID": 1,
      "Price": 24.00
    }
  ],
  "Page": 1,
  "PageSize": 50
}
20+ Endpoint Groups
3 Access Tiers
50ms Typical Cache Hit
100% Context-Scoped Responses
Platform Capabilities

Everything your systems
need to integrate.

Built around the workflows that run your business — from storefront ordering to back-office reconciliation.

01
Real-Time Product Catalog

Query active products filtered to your state and brand portfolio. Status filtering, pagination, and discontinued product exclusion handled automatically.

GET /products
02
Customer-Specific Pricing

Retrieve the exact unit price and promotions applicable to any customer on any effective date. Full-price, discount, and promotion attribution in every response.

GET /customerPricing
03
Live Inventory Levels

Access warehouse inventory and retailer on-hand quantities by product, location, and state. Continuously synchronized from source.

GET /inventory
04
Invoice & Order History

Pull invoices by customer, date range, and status. Drill into line items, COA documents, and payment transactions — all in a single call chain.

GET /invoices
05
Promotions & Allocations

Access active menu promotions, product allocations, and quantity pricing tiers. Build informed ordering tools without managing pricing logic yourself.

GET /allocations
06
Purchase Tracking for Brands

Brands can monitor the inventory they send KSS for warehousing and distribution. Track purchase status, quantities received, and current stock held on your behalf.

GET /purchases
For Retailers

Your orders and account data, on your terms.

Connect KSS data directly to your internal systems, buying tools, or ERP. Stop screen-scraping and start pulling structured data programmatically.

  • Check your product catalog and availability by state
  • Pull current pricing with active promotion details
  • Retrieve invoice history and line-item COA records
  • Monitor delivery days and next scheduled dates
  • Access AR aging balances and open invoice status
  • View recommended products curated for your account
For Brands

Full visibility into how your products move.

Everything scoped to your brand — purchase and inventory status, order history, and promotional reach — without touching data that isn't yours.

  • Track inventory you've sent KSS for warehousing and distribution
  • Monitor purchase status and quantities received into the warehouse
  • Query retailer on-hand inventory for your SKUs
  • Review invoices and transactions containing your products
  • Track active menu promotions by state and date range
  • Access product-level pricing and promotional tiers
Integration Path

From request to
production in days.

→
01
Request Access

Email our API team with your company name and intended use case. We'll provision a key scoped to your account type and authorized data.

→
02
Authenticate

Pass your key via the x-api-key header on every request. No OAuth flows, no session management.

→
03
Query Endpoints

All endpoints return paginated JSON. Filter by state, customer, brand, date range, and status using simple query parameters.

04
Build & Automate

Integrate into your systems, dashboards, or nightly jobs. Data is refreshed continuously from our Snowflake warehouse.

Endpoints

A complete surface area
for your KSS data.

GET /v1/products Catalog & status
GET /v1/inventory Warehouse stock
GET /v1/retailerInventory On-hand at accounts
GET /v1/customerPricing Account-level pricing
GET /v1/invoices Order history
GET /v1/invoiceTransactions Line-item detail
GET /v1/allocations Product allocations
GET /v1/menuPromotions Active promotions
GET /v1/customers Account profiles
GET /v1/suppliers Brand profiles
GET /v1/arAging Accounts receivable
// Standard paginated response envelope

{
  "Data": [ /* array of records */ ],
  "Page": 1,
  "PageSize": 50
}

// Common query parameters

States = "CA,NV,OR"
CustomerIDs = "1012,1048"
SupplierIDs = "14,22"
Statuses = "1,2"
StartDate = "2025-01-01"

// Authentication
x-api-key: "your_api_key_here"
Get Started

Ready to connect
your systems to KSS?

Reach out to our API support team to get your key provisioned. We typically respond within one business day.

api.support@kivaconfections.com

Include your company name and whether you're a retailer or brand