Skip to content
Sign in
Get started

Developers

Build on Anantak Commerce

Connect your shop to your own systems. Read and update products, orders, collections and more over a REST API, with keys scoped to one shop and only the permissions you need.

Request an API key
terminal
curl https://api.anantak.co/api/v1/shops/$SHOP_ID/products \
  -H "Authorization: Bearer anantak_…"

{
  "data": [
    { "id": "…", "title": "Ceramic vase", … }
  ],
  "pagination": { … }
}

The full API reference is coming soon. Until then, email us with what you'd like to build and we'll help you get started.

Authentication

Every request carries a shop API key as a Bearer token. Keys start with anantak_ and belong to exactly one shop: a key for one shop can't read another's data. Keys are issued by Velon Innovations at your request; tell us which permissions you need.

  • Send the key in the Authorization header: Bearer anantak_…
  • Each key carries only the permissions it was given, from the list below.
  • A key can also have its own rate limit.
  • Keep keys on your server. Never put one in a website or mobile app.

Requests and responses

All shop endpoints live under /api/v1/shops/{shopId}/ on the API host and speak JSON. The shop in the URL must be the key's shop.

https://api.anantak.co/api/v1/shops/{shopId}/…

Some of what's available

  • GET/productsList your products.
  • POST/productsCreate a product.
  • GET/ordersList orders.
  • POST/ordersCreate an order.
  • GET/collectionsList collections.
  • GET/customersList customers.

Permissions

Grant a key only what your integration uses. These are the permissions a key can carry:

  • product:view

    Read products.

  • product:manage

    Create, edit and delete products.

  • order:view

    Read orders and customers.

  • order:manage

    Create and edit orders.

  • order:fulfill

    Fulfil orders.

  • collection:manage

    Create and edit collections.

  • discount:view

    Read discounts.

  • discount:manage

    Create and edit discounts.

  • inventory:view

    Read stock levels.

  • inventory:adjust

    Adjust stock levels.

  • location:view

    Read your locations.

  • analytics:view

    Read dashboard figures.

Team roles

People in your shop have roles too, and the same permissions sit behind them. Owners and admins can do everything in the shop, including reports and managing the team. Managers run products, orders, discounts and deliveries. Staff fulfil orders, use the POS and drive deliveries.

Errors

Errors come back with an HTTP status and a JSON body holding an error code and a message. A missing or invalid key gets 401; a key without the needed permission gets 403. When your plan's limit is reached, for example the number of products, the API answers 403 with the code PLAN_LIMIT_EXCEEDED and the limit you hit.

Request an API key

The full API reference is coming soon. Until then, email us with what you'd like to build and we'll help you get started.

[email protected]