Omnifill Docs

Method	Path	Purpose
POST	/api/auth/signup	Create a new account. Sets session cookie on success.
POST	/api/auth/login	Log in with username or email and password. Sets session cookie.
POST	/api/auth/logout	Invalidate the current session and clear the cookie.
GET	/api/auth/me	Return the current user profile and subscription status.

POST /api/auth/signup

curl -X POST https://dashboard.omnifill.net/api/auth/signup \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "username": "myusername",
    "email": "[email protected]",
    "password": "atleast6chars"
  }'

Returns 201 with { "username": "...", "email": "..." } and sets the session cookie. Password must be at least 6 characters. Both username and email must be unique (case-insensitive for email).

If a subscription was purchased with the same email before sign-up, it is automatically linked to the new account.

POST /api/auth/login

curl -X POST https://dashboard.omnifill.net/api/auth/login \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{ "identifier": "myusername", "password": "mypassword" }'

The identifier field accepts either username or email address.

GET /api/auth/me

curl https://dashboard.omnifill.net/api/auth/me -b cookies.txt

{
  "username": "myusername",
  "email": "[email protected]",
  "hasStripeConnected": true,
  "hasPayPalConnected": false,
  "subscription": {
    "status": "active",
    "plan": "monthly",
    "currentPeriodEnd": "2026-06-02"
  }
}

Subscription status is one of: active, past_due, cancelled. The subscription field is null if no subscription record exists.

Method	Path	Purpose
GET	/api/orders	List all orders for the current account, joined with canonical product fields.
POST	/api/orders/import	Bulk import normalized orders.
PATCH	/api/orders/:id	Update an order's status.
POST	/api/orders/:id/product	Assign an order to a canonical product and save an alias.
DELETE	/api/orders	Delete all orders and reset sync timestamps.

Returns an array of orders sorted by date descending, joined with canonical product fields when a product is assigned.

Field	Type	Description
id	string	Omnifill ID in ABC-1234-DEFG format.
source	string	Origin platform: stripe, paypal, shopify, woocommerce, kickstarter, or any custom string.
date	string	Order date in YYYY-MM-DD format.
first_name	string	Customer first name.
last_name	string	Customer last name.
email	string	Customer email address.
phone	string	Customer phone number.
address_line1	string	Street address.
city	string	City.
postal_code	string	Postal or ZIP code.
country	string	Two-letter country code (e.g. US, GB).
product	string	Raw product name as received from the source.
product_id	integer	ID of the assigned canonical product, or null.
product_name	string	Canonical product name (joined), or null.
product_sku	string	Canonical product SKU, or null.
product_image_data	string	Product image as a data URL, or null.
qty	integer	Quantity ordered. Defaults to 1.
amount	string	Order total with 2 decimal places (e.g. "120.00").
currency	string	Lowercase ISO 4217 currency code.
status	string	paid, routed, or problem.
created_at	string	ISO 8601 datetime when the record was created in Omnifill.

Import an array of orders. Orders are deduplicated by source + source_id per account - re-importing the same order only updates the product assignment if it changed.

curl -X POST https://dashboard.omnifill.net/api/orders/import \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "orders": [
      {
        "source": "kickstarter",
        "source_id": "backer-1001",
        "date": "2026-05-02",
        "firstName": "Mira",
        "lastName": "Stone",
        "email": "[email protected]",
        "country": "US",
        "product": "Deluxe board game",
        "qty": 2,
        "amount": "120.00",
        "currency": "usd"
      }
    ]
  }'

Returns: { "inserted": 1, "total": 1 }

If a product name matches an existing alias, the order is automatically assigned to the corresponding canonical product on import.

Import field reference

Field	Aliases accepted	Required	Description
source	-	Yes	Platform identifier. Use lowercase (e.g. stripe, paypal, shopify, woocommerce, kickstarter, csv).
source_id	sourceId	Recommended	ID from the originating platform. Required for reliable deduplication.
date	-	-	Order date, YYYY-MM-DD.
firstName	first_name	-	Customer first name.
lastName	last_name	-	Customer last name.
email	-	-	Customer email.
phone	-	-	Customer phone.
addressLine1	address_line1	-	Street address.
city	-	-	City.
postalCode	postal_code	-	Postal or ZIP code.
country	-	-	Two-letter country code.
product	-	-	Raw product name from the source.
qty	-	-	Quantity. Defaults to 1.
amount	-	-	Order total as a string or number.
currency	-	-	Lowercase ISO 4217. Defaults to usd.
status	-	-	Defaults to paid.

Update the status of a single order. Only the status field can be changed via this endpoint.

curl -X PATCH https://dashboard.omnifill.net/api/orders/ABC-1234-DEFG \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{ "status": "routed" }'

Valid values: paid, routed, problem. Returns { "ok": true }, or 404 if not found.

Assign an order to a canonical product. Omnifill saves the raw product name on the order as an alias, and bulk-updates all other currently unassigned orders that share the same raw product name.

curl -X POST https://dashboard.omnifill.net/api/orders/ABC-1234-DEFG/product \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{ "product_id": 1 }'

Returns: { "ok": true, "product_id": 1 }

Deletes all orders for the current account and resets the Stripe and PayPal sync timestamps so the next sync fetches everything from scratch.

curl -X DELETE https://dashboard.omnifill.net/api/orders -b cookies.txt

Returns: { "ok": true, "deleted": 42 }

Method	Path	Purpose
GET	/api/products	List products with aliases, assigned order count, and remaining stock.
GET	/api/products/stock	Slim stock summary - IDs, names, SKUs, and stock numbers only.
POST	/api/products	Create a product.
PATCH	/api/products/:id	Update a product.
DELETE	/api/products/:id	Delete a product. Detaches linked orders by setting their product_id to null.

Field	Aliases	Type	Description
name	-	string	Canonical product name. Required.
sku	-	string	Optional internal SKU.
image_data	imageData	string	Product image as a data URL (PNG, JPEG, or WebP only; max ~800 KB). The dashboard resizes images to fit within 512x512 before uploading.
no_fulfillment	noFulfillment	boolean	Marks products that should be skipped in fulfillment exports, such as digital items, tips, or add-ons that do not ship.
track_stock	trackStock	boolean	Enables inventory counting for this product.
stock_qty	stockQty	integer	Total units in stock before assigned orders are subtracted.
aliases	-	array	Raw product names to recognize as this product. Each element is a plain string or { "raw_name": "...", "source": "..." }. If a name is already aliased to another product, it is reassigned.

Example: create a product with aliases

curl -X POST https://dashboard.omnifill.net/api/products \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "name": "Deluxe board game",
    "sku": "DGB-001",
    "no_fulfillment": false,
    "track_stock": true,
    "stock_qty": 50,
    "aliases": [
      { "raw_name": "Deluxe box pledge", "source": "stripe" },
      "Deluxe board game reward"
    ]
  }'

Returns 201 with { "ok": true, "product": { ... } } containing the full product object including computed stock fields.

[
  {
    "id": 1,
    "name": "Deluxe board game",
    "sku": "DGB-001",
    "image_data": null,
    "track_stock": true,
    "stock_qty": 50,
    "assigned_qty": 44,
    "order_count": 22,
    "remaining_stock": 6,
    "aliases": [
      { "raw_name": "Deluxe box pledge",        "source": "stripe" },
      { "raw_name": "Deluxe board game reward",  "source": null }
    ],
    "created_at": "2026-05-01T10:00:00",
    "updated_at": "2026-05-02T09:30:00"
  }
]

remaining_stock is null when inventory tracking is off. assigned_qty sums order quantities where status != 'problem'. order_count is the number of distinct orders assigned to this product.

Use GET /api/products/stock for a compact view without aliases or image data.

remaining_stock = stock_qty - assigned_qty

If track_stock is false, remaining_stock is null. remaining_stock is clamped to 0 and will not go negative in API responses.

[
  {
    "id": 1,
    "name": "Deluxe board game",
    "sku": "DGB-001",
    "track_stock": true,
    "stock_qty": 50,
    "assigned_qty": 44,
    "remaining_stock": 6
  }
]

Date filtering

Pass either a preset rolling window or a custom date range as query parameters:

Parameter	Values	Description
range	7, 30, 90, all	Rolling window in days. Default is all.
from + to	YYYY-MM-DD	Custom inclusive date range. Both must be present; from must be ≤ to. Takes priority over range.

curl "https://dashboard.omnifill.net/api/analytics?range=30" -b cookies.txt

curl "https://dashboard.omnifill.net/api/analytics?from=2026-04-01&to=2026-04-30" -b cookies.txt

Response

{
  "kpis": {
    "totalRevenue":    3480.00,
    "totalOrders":     87,
    "fulfillmentRate": 0.644,
    "avgOrderValue":   40.00,
    "currency":        "usd"
  },
  "ordersOverTime": [
    { "date": "2026-04-01", "count": 5, "revenue": 200.00 }
  ],
  "bySource": [
    { "source": "stripe",      "count": 60, "revenue": 2400.00 },
    { "source": "kickstarter", "count": 27, "revenue": 1080.00 }
  ],
  "byStatus": [
    { "status": "paid",   "count": 31 },
    { "status": "routed", "count": 56 }
  ],
  "byCountry": [
    { "country": "US", "count": 42 },
    { "country": "GB", "count": 18 }
  ]
}

fulfillmentRate is a decimal 0-1 (1.0 = 100% routed). currency reflects the most common currency among filtered orders. byCountry returns the top 10 countries; blank and N/A entries are excluded.

Method	Path	Purpose
GET	/api/stripe/status	Check if a Stripe account is connected and return the account ID.
GET	/api/stripe/connect	Initiate OAuth - redirects to Stripe's authorization page.
DELETE	/api/stripe/disconnect	Revoke access and remove stored Stripe credentials.
POST	/api/stripe/sync	Pull orders from Stripe into Omnifill.

Mode	What it fetches
charges (default)	All charges via /v1/charges. Best for accounts using the Charges API directly.
checkout_sessions	Completed checkout sessions via /v1/checkout/sessions. Best for Stripe Checkout.
payment_link	Sessions for a specific payment link. Requires paymentLinkId starting with plink_.

// Sync all charges
curl -X POST https://dashboard.omnifill.net/api/stripe/sync \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{ "mode": "charges" }'

// Sync a specific payment link
curl -X POST https://dashboard.omnifill.net/api/stripe/sync \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{ "mode": "payment_link", "paymentLinkId": "plink_xxx" }'

// Force a full re-sync
curl -X POST https://dashboard.omnifill.net/api/stripe/sync \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{ "mode": "charges", "force": true }'

The first sync is always a full sync - it deletes existing Stripe orders for the account and fetches everything. Subsequent syncs are incremental, fetching only items created after the last sync timestamp minus a 1-hour buffer to catch stragglers. Pass "force": true to reset to a full sync at any time.

Product name extraction (charges)

Omnifill tries to extract a product name from these charge fields in order: description, metadata.product_name, metadata.product, metadata.item. Generic strings like "Stripe Payment" and "Stripe Checkout" are discarded and left blank.

{
  "connected": true,
  "accountId": "acct_xxx"
}

Method	Path	Purpose
GET	/api/paypal/status	Check if a PayPal account is connected and return its email.
GET	/api/paypal/connect	Initiate OAuth - redirects to PayPal's authorization page.
DELETE	/api/paypal/disconnect	Remove stored PayPal credentials.
POST	/api/paypal/sync	Pull transactions from PayPal into Omnifill.

Sync transactions for a date range. Default is the last 30 days.

// Default: last 30 days
curl -X POST https://dashboard.omnifill.net/api/paypal/sync \
  -H "Content-Type: application/json" -b cookies.txt -d '{}'

// Custom date range
curl -X POST https://dashboard.omnifill.net/api/paypal/sync \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{
    "startDate": "2026-01-01T00:00:00+0000",
    "endDate":   "2026-03-31T23:59:59+0000"
  }'

Returns: { "inserted": 12, "total": 12 }

Transaction status mapping

PayPal status code	Omnifill status
S (Success), P (Pending)	paid
D (Denied), V (Reversed), F (Failed)	problem
any other	paid

{
  "connected": true,
  "email": "[email protected]"
}

Method	Path	Purpose
GET	/api/shopify/status	Check if a Shopify store is connected and return the shop domain.
GET	/api/shopify/connect?shop=example.myshopify.com	Initiate OAuth - redirects to Shopify's authorization page.
POST	/api/shopify/sync	Pull paid Shopify orders into Omnifill.
DELETE	/api/shopify/disconnect	Remove stored Shopify credentials.

curl -X POST https://dashboard.omnifill.net/api/shopify/sync -b cookies.txt

Returns { "inserted": 12, "total": 12 }. Repeated syncs are deduplicated by source and source_id.

Method	Path	Purpose
GET	/api/woocommerce/status	Check if a WooCommerce store is connected and return its store URL.
GET	/api/woocommerce/connect?store_url=https://example.com	Initiate WooCommerce app authorization.
POST	/api/woocommerce/sync	Pull WooCommerce orders into Omnifill.
DELETE	/api/woocommerce/disconnect	Remove stored WooCommerce credentials.

curl -X POST https://dashboard.omnifill.net/api/woocommerce/sync -b cookies.txt

Returns { "inserted": 12, "total": 12 }. Repeated syncs are deduplicated by source and source_id.

ID	What is checked
web	Public marketing site at omnifill.net
dashboard	Dashboard app at dashboard.omnifill.net
api	API server health via GET /api/health
stripe	Reachability of api.stripe.com
paypal	Reachability of api-m.paypal.com

Returns the most recent check result for each component.

curl https://dashboard.omnifill.net/api/status/current

{
  "web":       { "status": "operational", "latency_ms": 42,  "checked_at": "2026-05-02T14:30:00" },
  "dashboard": { "status": "operational", "latency_ms": 38,  "checked_at": "2026-05-02T14:30:00" },
  "api":       { "status": "operational", "latency_ms": 5,   "checked_at": "2026-05-02T14:30:00" },
  "stripe":    { "status": "operational", "latency_ms": 180, "checked_at": "2026-05-02T14:30:00" },
  "paypal":    { "status": "operational", "latency_ms": 210, "checked_at": "2026-05-02T14:30:00" }
}

Status values: operational, outage, or unknown (no data recorded yet).

Returns a daily aggregated status across all components for the last 90 days.

curl https://dashboard.omnifill.net/api/status/history

[
  { "day": "2026-04-01", "status": "operational" },
  { "day": "2026-04-02", "status": "outage" }
]

A day is outage if any component had any failed check that day, otherwise operational.

1. Log in

curl -X POST https://dashboard.omnifill.net/api/auth/login \
  -H "Content-Type: application/json" -c cookies.txt \
  -d '{ "identifier": "yourusername", "password": "yourpassword" }'

2. Create a product

curl -X POST https://dashboard.omnifill.net/api/products \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{
    "name": "Deluxe board game",
    "sku": "DGB-001",
    "track_stock": true,
    "stock_qty": 50
  }'

3. Import orders

If an order's product name matches an existing alias, Omnifill assigns it automatically on import.

curl -X POST https://dashboard.omnifill.net/api/orders/import \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{
    "orders": [
      {
        "source": "kickstarter",
        "source_id": "backer-1001",
        "date": "2026-05-02",
        "firstName": "Mira",
        "lastName": "Stone",
        "email": "[email protected]",
        "country": "US",
        "product": "Deluxe board game",
        "qty": 2,
        "amount": "120.00",
        "currency": "usd"
      }
    ]
  }'

4. Assign an unrecognized order to a product

Assigning an order saves its raw product name as an alias and bulk-updates all other unassigned orders with the same name.

curl -X POST https://dashboard.omnifill.net/api/orders/ABC-1234-DEFG/product \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{ "product_id": 1 }'

5. Mark an order routed

curl -X PATCH https://dashboard.omnifill.net/api/orders/ABC-1234-DEFG \
  -H "Content-Type: application/json" -b cookies.txt \
  -d '{ "status": "routed" }'

6. Check remaining stock

curl https://dashboard.omnifill.net/api/products/stock -b cookies.txt

7. Pull analytics for the last 30 days

curl "https://dashboard.omnifill.net/api/analytics?range=30" -b cookies.txt

Omnifill supports Stripe, PayPal, Shopify, and WooCommerce connections, plus CSV imports for crowdfunding and marketplace exports such as Kickstarter, Indiegogo, and Gamefound.

No. Omnifill sits between those systems. It collects order data from the places where you sell, normalizes it, and prepares the clean order set your fulfillment partner needs.

Yes. CSV export is the standard fallback. The Export screen includes fulfillment-oriented profiles, field mappings, validation, and a preview so you can generate files that warehouses can map during intake.

Direct API routing is partner-specific and available where supported. It requires partner credentials and setup on the backend. If a partner does not have a supported direct route yet, use CSV export.

Each imported order stores the source platform and the source order ID. Omnifill uses that pair per account for deduplication, so re-running a sync or re-importing the same CSV does not create a second copy of the same order.

Products represent the items your fulfillment partner needs to pick and ship. Aliases let messy source names map to the right product automatically, so names from Stripe, Shopify, Kickstarter, or PayPal can all resolve to one SKU.

Yes. Mark a product as no_fulfillment to keep it out of fulfillment exports. This is useful for digital goods, tips, warranties, or add-ons that do not physically ship.

No transaction fee is added by Omnifill. Current pricing is a 14-day free trial, then $12/month or $120/year. Your payment processors, storefronts, warehouses, and shipping providers may charge their own fees.

Yes. Selected Kickstarter campaigns can receive 3 months free and personalized onboarding. Apply at https://omnifill.net/kickstarter.

Omnifill stores account details, source connection tokens, imported order data, products, aliases, export settings, and subscription status as needed to run the service. See the privacy policy for the full legal description.

Email [email protected]. Include the source you are using, a short description of the issue, and any affected Omnifill order IDs if the problem involves specific orders.