Store Gate API

Store Gate is Qumra's GraphQL API for accessing store data. Use it to build apps that interact with products, collections, cart, checkout, and customer data.

Endpoint

POST https://<store-subdomain>.qumra.store/graphql

Authentication

Include your token in the Authorization header:

Authorization: Bearer <TOKEN>

Quick Example

curl -X POST https://my-store.qumra.store/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  -d '{"query": "{ store { name currency } }"}'

const response = await fetch('https://my-store.qumra.store/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify({
    query: `{ store { name currency } }`
  })
});

const data = await response.json();

Available Queries

Category	Operations
Products	Get products, filter, search
Collections	Get collections and their products
Cart	Add, update, remove items
Checkout	Create checkout, calculate shipping
Customer	Login, signup, addresses
Orders	Create and track orders
Wishlist	Manage wishlists

Example Queries

Get Products

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        price
        images {
          src
        }
      }
    }
  }
}

Add to Cart

mutation {
  addToCart(input: {
    productId: "123"
    quantity: 1
  }) {
    success
    cart {
      items {
        title
        quantity
      }
    }
  }
}

Get Customer

query {
  customer {
    id
    email
    firstName
    lastName
    addresses {
      city
      country
    }
  }
}

Response Format

All responses follow this structure:

{
  "data": {
    "products": { ... }
  },
  "errors": []
}

Error Handling

Check the errors array for any issues:

{
  "errors": [
    {
      "message": "Product not found",
      "path": ["product"]
    }
  ]
}