Build smarter
vending & retail
integrations

The VenHub API gives developers full programmatic control over inventory, orders, and hub operations. Ship faster with clean REST endpoints and comprehensive docs.

Live Demo Explore the API

bash

# Fetch live inventory for your hub
$ curl -X GET "https://tina-api.venhub.com/api/v1/owners/hub_inventory/?hub_id=123" \
    --header "X-API-Key: vh_abc123..."

# Response
[
  {
    "id": 1,
    "name": "Organic Apple",
    "quantity": 25,
    "original_price": 299,
    "discounted_price": 299
  }
]

API Endpoints

Permission Scopes

Everything you need to build

Modular APIs designed around how vending and retail businesses actually operate.

🏪

Hubs API

List hubs, retrieve configuration, check real-time health, and manage door access.

8 endpoints

📦

Inventory API

Read and update product stock, prices, UPCs, and physical locations across your hubs.

6 endpoints

🛒

Orders API

Retrieve paginated order history and process full or partial refunds programmatically.

3 endpoints

📊

Analytics API

Query revenue, sales breakdowns, customer growth, and top products by hub.

13 endpoints

⚙️

Controls API

Send direct hardware commands to vending bins and refrigerated cabinets.

17 endpoints

🔧

Maintenance API

Create and retrieve maintenance reports with photo and video attachments.

3 endpoints

🏷️

Promotions API

Manage hub banners and create deals with automatic discounts at checkout.

9 endpoints

🔑

Authentication

API key or Firebase authentication with scope-based access control per hub and permission level.

12 scopes

Clean, predictable REST

Every endpoint follows consistent patterns — same auth header, same error shapes, same pagination model. Less time reading docs, more time shipping.

View all endpoints

Update product quantity

# Requires scope: inventory:write
curl -X PUT \
  "https://tina-api.venhub.com/api/v1/owners/hubs/
   product/456/update_quantity" \
  --header "X-API-Key: vh_abc123..." \
  --header "Content-Type: application/json" \
  --data '{"quantity": 50}'

# 200 OK
{
  "success": true
}

Built for real integrations

🔐

Scoped permissions

Issue API keys with only the scopes your integration needs. Read-only keys for dashboards, write keys for automation.

📄

Cursor-based pagination

Orders API uses cursor pagination so you can reliably page through thousands of records without missed or duplicate results.

🏪

Multi-hub support

A single API key can be scoped to one or many hubs. Build dashboards that aggregate across your entire fleet.

💰

Cents-based pricing

All monetary values are integers in cents — no floating-point surprises. 299 always means $2.99.

🔄

Flexible refunds

Process full-order refunds or target individual line items, routed back to the customer's bank account.

📍

Physical location lookup

Query products by cabinet, shelf, and row — perfect for IoT restocking systems and hardware integrations.

Build smarter vending & retail integrations