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.

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...

Rate Limit Tiers

Tier Rate Limit Description
Free 100 requests / day For testing and development
Starter 1,000 requests / day For production applications
Enterprise Unlimited Custom limits, priority support

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.

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

Download YAML