Introduction

Welcome to the Elmatajer API — the REST API behind every store on the Elmatajer platform. Use it to read and update orders, products, categories, customers and shipping zones, and to receive webhooks the moment something happens in a store.

#What you can build

• Order tools — send orders to a shipping company or a fulfilment centre, update their status, add notes.
• Supplier & dropshipping apps — create products, keep stock in sync by SKU, receive the orders that contain your products.
• WhatsApp & messaging apps — order confirmation, delivery updates, abandoned-cart reminders.
• Accounting & ERP sync, reports, and anything else that works with a store's data.

#Getting started

1. Get a key — the store owner creates one in their dashboard: Domains & apps → Public API (Authentication). For an app used by many stores, use the install link instead.
2. Call the API — send the key in the Api-Key header to https://elmatajer.com/api/v1/vendor.
3. Receive webhooks — add a webhook URL to the key and get signed order.created events (Webhooks).

curl https://elmatajer.com/api/v1/vendor/orders?limit=5 \
  -H "Api-Key: YOUR_API_KEY"

#Conventions

• JSON in, JSON out. Send Accept: application/json.
• Every response has status (ok or error); data is in data, paging in meta.
• Times are ISO 8601 with the store's offset. Money is a number in the store's currency (currency_code).
• Limits: 60 calls a minute per key (Rate limits).