Developer Preview

Majir Rewards API

Integrate click attribution and rewards tracking into your application. Track user engagement, attribute conversions, and unlock cashback for your users.

Get API Key View API Reference

Quick Start

1

Register

Sign up below to get your API key. You'll receive a key starting with mjr_live_

2

Make a Request

Send your API key in the X-Majir-API-Key header with every request.

3

Track Rewards

Record click events, track conversions, and monitor your usage through the API dashboard endpoints.

Example Request

curl -X POST https://api.majir.shop/api/v1/events/click \
  -H "Content-Type: application/json" \
  -H "X-Majir-API-Key: mjr_live_your_key_here" \
  -d '{"offer_id": "offer_123", "url": "https://example.com/deal"}'

Authentication

All API requests require authentication via the X-Majir-API-Key header. You receive your API key when you register as a developer.

API Key Format

Keys use the prefix mjr_live_ followed by a random string. Example:

X-Majir-API-Key: mjr_live_a1b2c3d4e5f6...

Pricing & Rate Limit Tiers

Tier Price Rate Limit Best For
Free $0 100 requests / day Testing and prototypes
Starter $29 / mo 1,000 requests / day Production apps
Enterprise $299 / mo + usage Unlimited (50k/day soft cap) High-volume partners

Every developer starts on the Free tier — no credit card required. Upgrade to Starter or Enterprise from your dashboard after registering. Contact sales@majir.shop for custom enterprise terms.

Response Format

All API responses use a consistent JSON envelope:

{
  "success": true,
  "data": { ... },
  "meta": {
    "timestamp": "2026-03-27T12:00:00Z"
  },
  "error": null
}

Error Codes

400

Bad Request

Invalid or missing parameters. Check the request body.

401

Unauthorized

Missing or invalid API key. Include X-Majir-API-Key header.

403

Forbidden

Your API key does not have permission for this action.

429

Too Many Requests

Rate limit exceeded. Check your tier limits and retry later.

500

Internal Server Error

Something went wrong on our end. Retry or contact support.

Get Your API Key

Register to receive your free API key instantly. No credit card required.

You'll start on the Free tier (100 req/day). Upgrade to Starter — $29/mo or Enterprise — $299/mo anytime from your dashboard.

SDKs & Tools

Official client libraries are coming soon. In the meantime, use the REST API directly with any HTTP client.

Node.js SDK

Coming soon

Python SDK

Coming soon

OpenAPI Spec

Coming soon