Getting started

API Playground

Interactive API testing and exploration

API Playground

Test Geins APIs directly in your browser without writing any code.

GraphQL Playground (Merchant API)

The Merchant API uses GraphQL, which means you can explore the entire API schema and test queries interactively.

Using the Built-in Explorer

  1. Navigate to https://merchantapi.geins.io/graphql
  2. Add your API key header: X-ApiKey: {MERCHANT_API_KEY}
  3. Use the schema explorer to discover available queries and mutations

Sample Queries to Try

query {
  products(take: 5) {
    products {
      productId
      name
      alias
    }
  }
}

REST Explorer (Management API)

For the Management API, we recommend using:

  • Postman — Import our Postman collection
  • cURL — Quick command-line testing
  • Your IDE — HTTP client extensions for VS Code, IntelliJ

Sample REST Calls

# List markets
curl 'https://mgmtapi.geins.io/API/Market/List' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'X-ApiKey: {MGMT_API_KEY}'

# Get product by ID
curl 'https://mgmtapi.geins.io/API/Product/123' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'X-ApiKey: {MGMT_API_KEY}'

Tools & Extensions

ToolAPIFeatures
GraphQL PlaygroundMerchantSchema explorer, auto-complete, history
PostmanBothCollections, environment variables, tests
InsomniaBothGraphQL support, API design
VS Code REST ClientBothIn-editor HTTP requests

Need Help?

Full API Reference

Complete documentation for all endpoints

MCP Server

AI-powered help in your IDE