API reference

The API is GraphQL over a single endpoint. What follows is the SUPPORTED surface — the operations we commit to keeping stable for integrations.

The schema exposes far more than this list. Anything not listed here is internal: it can change or disappear in any release without notice. Build on the listed operations and you will not be broken by an upgrade.

Endpoint

A single POST endpoint at /admin-api. Introspection is available with a valid key, so any GraphQL client can generate types from the live schema.

Orders

OperationWhat it does
orders(options)List orders, filtered and paginated.
order(id)One order with its lines, totals, addresses and state.
transitionOrderToState(id, state)Move an order forward (e.g. to shipped).
addFulfillmentToOrder(input)Record a fulfilment against order lines.

Products and stock

OperationWhat it does
products(options)List products.
product(id | slug)One product with its variants.
createProduct / updateProductCreate or edit a product.
createProductVariants / updateProductVariantsManage variants, prices and SKUs.
updateProductVariants(stockOnHand)The stock write path — this is how a stock sync works.
collections / collection(id | slug)Read the store’s categories.

Customers

OperationWhat it does
customers(options)List customers of this store.
customer(id)One customer with their addresses and order history.

Customer identity is namespaced per store: the same person shopping at two eMatjarak stores is two independent customer records. Do not assume an email address identifies someone globally.

Store settings

OperationWhat it does
activeStoreSettingsThe store’s own settings: slug, branding, theme, custom domain, plan.
myPlanThe store’s plan, its limits and current usage.
myWebhooksThe store’s webhook endpoints and the supported event list.

Money and dates

  • All money is an integer in the currency’s minor units. 185000 SYP is 185000, not 1850.00.
  • Every amount comes with its currencyCode. A store can sell in more than one.
  • Dates are ISO 8601 strings in UTC.