Developers
Build on the counter
independent stores already run
A REST API and signed webhooks for products, inventory with lot numbers, customers, orders and purchase orders.
curl https://app.blackbeachpos.com/api/v1/inventory/lots?status=expiring \
-H "Authorization: Bearer ir_live_…"What you can build
Connect the systems around the register
Channel managers
Read on-hand stock per store, lots included, get every change as it happens, and place and receive purchase orders. Flxpoint-style sync with the counter as the source of truth.
Marketplace orders
Put Etsy, Amazon and eBay orders on the POS so stock comes off the right shelf and the right lot. Marketplace-collected tax is never charged twice.
Email and SMS marketing
Sync customers with marketing opt-in, spend and purchase history. Birthdays only when the shop opts that key in.
Accounting and reporting
Every sale, payment, return and purchase order in integer cents, incrementally with updated_since.
Expiry and freshness tools
Lot numbers with expiry dates per store: find what expires this month, what already has, and which lot each sale came from.
Your own tools
Price updates from a pricing engine, product data from a PIM, stock counts from a scanner app. Anything a key is allowed to do.
How it works
Secure by default, configurable by the owner
Scoped keys
The shop owner issues each key with none, read or write per resource, optional store limits, IP allowlists and expiry. Roll with a grace period; revoke instantly.
Signed webhooks
21 event types, HMAC-SHA256 signatures with secret rotation, retries for about 37 hours, a delivery log with resend, and a catch-up feed.
Built for syncing
Cursor pagination, updated_since on every list, Idempotency-Key on every write, and external_reference on orders so retries never double-sell.
Private stays private
Customer ID documents, staff notes and staff accounts aren't in the API at any permission level, and birthdays are opt-in per key.
Plans
Included on Established and Enterprise
Established includes the API at 60 requests a minute and 10,000 a day. Enterprise raises it to 600 a minute with no daily cap. Limits are per shop and shared by its keys. Getting Started doesn't include API access.
See pricingSandbox
A test shop that keeps moving
Development partners get their own sandbox shop with a real catalog, lots with expiry dates, customers and history. Every day brings new sales, receivings and returns, so your syncs and webhooks see real traffic. It's rebuilt weekly.