Getting Started

This guide walks you through setting up your development environment and making your first API call to the Wemarka API.

Prerequisites

• A Wemarka seller account with an approved store.
• An API key from the Developer Portal.

Base URL

All API requests are made to:

https://api.wemarka.com/api/v1

For local development:

http://localhost:3001/api/v1

Your First Request

List active stores on the platform:

curl -H "Authorization: Bearer wk_live_your_key" \
  https://api.wemarka.com/api/v1/tenants?limit=5

Response:

{
  "data": [
    {
      "id": "...",
      "name": "My Store",
      "slug": "my-store",
      "logoUrl": "..."
    }
  ],
  "total": 42
}

Common Patterns

Pagination

List endpoints accept limit and offset query parameters:

# Get items 25-48
curl -H "Authorization: Bearer wk_live_..." \
  "https://api.wemarka.com/api/v1/tenants?limit=24&offset=24"

Error Handling

The API returns standard HTTP status codes. Error responses include a JSON body:

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid input: limit must be between 1 and 100"
  }
}

Next Steps

• Learn about Authentication in detail.
• Browse the API Reference for all available endpoints.