§ DEVELOPERS · REST · JSON

Build on numu.

Your store, as a REST API: products, orders, shipping, invoices and customers. Mint a scoped token, subscribe to events, build your own tools.

§ REST

REST + JSON

Predictable resource URLs, standard HTTP verbs, JSON everywhere.

§ WEBHOOKS

Webhooks

Signed, retried deliveries for order, payment and product events. Test and rotate from the API.

§ TOKENS

Scoped API tokens

Mint a token per integration, scoped per domain and pinned to one store. Revoke it any time.

§ REFERENCE

Live API reference

An OpenAPI document generated from the running API — point your client generator at it.

Quick example

# Send every paid order to your own system.
# NUMU_TOKEN is a scoped token you minted in the dashboard.

curl -X POST \
  https://numueg.app/api/v1/stores/$STORE_ID/webhooks \
  -H "Authorization: Bearer $NUMU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://erp.example.com/hooks/numu",
    "events": ["order.paid", "order.status_changed"],
    "description": "ERP sync"
  }'

# =>
# {
#   "id": "8f2b...",
#   "events": ["order.paid", "order.status_changed"],
#   "is_active": true,
#   "secret": "shown once — sign every delivery with it"
# }

# Each delivery carries:
#   X-NUMU-Event:        order.paid
#   X-NUMU-Delivery:     <id, stable across retries>
#   X-NUMU-Signature-V1: t=<unix>,v1=<hmac sha256 of "t.body">

Endpoints at a glance

POST/api/v1/public/waitlistSubmit email to the Founder's 100 waitlist.

POST/api/v1/public/contactSubmit a contact or callback request.

GET/api/v1/public/pricing-plansList active pricing plans with features and promos.

POST/api/v1/auth/registerCreate a merchant account — returns an access token.

POST/api/v1/stores/{store_id}/access-tokensMint a scoped API token. The secret is shown once.

GET/api/v1/stores/{store_id}/orders/List orders with filters, pagination, and status facets.

POST/api/v1/stores/{store_id}/shipments/waybillsGenerate a courier waybill for an order. No form-filling.

GET/api/v1/stores/{store_id}/invoices/by-order/{order_id}Fetch the ETA-compliant e-invoice for an order.

POST/api/v1/stores/{store_id}/webhooksSubscribe an endpoint to order and product events.

Full reference: /api/v1/public/docs

§ EARLY ACCESS

API is in private beta

We're onboarding founding developers to help shape the API. Want in on the first wave?

Request access Browse the App Store