API Reference

https://mrrx.app/api/v1

Authorization: Bearer mrrx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1706540400

curl -X POST https://mrrx.app/api/v1/sessions \
  -H "Authorization: Bearer mrrx_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_ABC123",
    "subscription_id": "sub_XYZ789",
    "return_url": "https://yourapp.com/account",
    "metadata": {
      "user_id": "usr_123",
      "plan": "pro"
    }
  }'

{
  "id": "ses_abc123xyz",
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "url": "https://mrrx.app/c/eyJhbGciOiJIUzI1NiIs...",
  "expires_at": "2026-01-30T12:00:00.000Z",
  "status": "created"
}

curl https://mrrx.app/api/v1/sessions/ses_abc123xyz \
  -H "Authorization: Bearer mrrx_live_xxxxx"

{
  "id": "ses_abc123xyz",
  "status": "completed",
  "subscription": {
    "id": "sub_XYZ789",
    "product_name": "Pro Plan",
    "price": {
      "amount": 2900,
      "currency": "usd",
      "interval": "month"
    },
    "current_period_end": "2026-02-15T00:00:00.000Z"
  },
  "outcome": {
    "action": "pause",
    "executed_at": "2026-01-29T15:30:00.000Z",
    "details": {
      "pause_duration_days": 30,
      "resume_date": "2026-03-17T00:00:00.000Z"
    }
  },
  "survey_response": {
    "reason": "not_using_enough",
    "reason_other": null,
    "feedback": "Taking a break to focus on other projects"
  },
  "created_at": "2026-01-29T14:00:00.000Z",
  "expires_at": "2026-01-30T14:00:00.000Z"
}

"details": {
  "pause_duration_days": 30,
  "resume_date": "2026-03-17T00:00:00.000Z"
}

"details": {
  "discount_type": "percent",
  "discount_amount": 25,
  "duration_months": 3,
  "coupon_id": "coup_abc123"
}

"details": {
  "previous_price_id": "price_old123",
  "new_price_id": "price_new456",
  "new_amount": 1900
}

"details": {
  "extension_days": 14,
  "new_trial_end": "2026-02-12T00:00:00.000Z",
  "original_trial_end": "2026-01-29T00:00:00.000Z"
}

"details": {
  "canceled_at": "2026-01-29T15:30:00.000Z",
  "cancel_at_period_end": false
}

{
  "status": "healthy",
  "timestamp": "2026-01-29T15:30:00.000Z",
  "version": "1.0.0"
}

{
  "error": {
    "code": "invalid_subscription",
    "message": "Subscription not found or not active",
    "details": {
      "subscription_id": "sub_invalid"
    }
  }
}

curl "https://mrrx.app/api/v1/sessions?limit=50" \
  -H "Authorization: Bearer mrrx_live_xxxxx"

{
  "data": [ ... ],
  "pagination": {
    "has_more": true,
    "next_cursor": "ses_abc123xyz"
  }
}

curl "https://mrrx.app/api/v1/sessions?limit=50&cursor=ses_abc123xyz" \
  -H "Authorization: Bearer mrrx_live_xxxxx"

curl -X POST https://mrrx.app/api/v1/sessions \
  -H "Authorization: Bearer mrrx_live_xxxxx" \
  -H "Idempotency-Key: unique-request-id-123" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

class MrrxClient {
  private apiKey: string;
  private baseUrl = 'https://mrrx.app/api/v1';

  constructor(apiKey: string) {
    this.apiKey = apiKey;
  }

  async createSession(params: {
    customer_id: string;
    subscription_id: string;
    return_url?: string;
    metadata?: Record<string, string>;
  }) {
    const response = await fetch(`${this.baseUrl}/sessions`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(params),
    });

    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.error.message);
    }

    return response.json();
  }

  async getSession(sessionId: string) {
    const response = await fetch(`${this.baseUrl}/sessions/${sessionId}`, {
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
      },
    });

    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.error.message);
    }

    return response.json();
  }
}

// Usage
const mrrx = new MrrxClient(process.env.MRRX_API_KEY!);
const session = await mrrx.createSession({
  customer_id: 'cus_xxx',
  subscription_id: 'sub_xxx',
  return_url: 'https://yourapp.com/account'
});

// Redirect user to session.url
window.location.href = session.url;

{
  "id": "evt_abc123",
  "type": "session.completed",
  "created_at": "2026-01-29T15:30:00.000Z",
  "data": {
    "session_id": "ses_abc123xyz",
    "subscription_id": "sub_XYZ789",
    "customer_id": "cus_ABC123",
    "action": "pause",
    "outcome": {
      "action": "pause",
      "details": {
        "pause_duration_days": 30,
        "resume_date": "2026-03-17T00:00:00.000Z"
      }
    },
    "survey_response": {
      "reason": "not_using_enough"
    }
  }
}

X-MRRX-Signature: t=1706540400,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

import crypto from 'crypto';

function verifyWebhook(
  payload: string,
  signatureHeader: string,
  secret: string
): boolean {
  // Parse the signature header
  const parts = signatureHeader.split(',');
  const timestamp = parts.find(p => p.startsWith('t='))?.slice(2);
  const signature = parts.find(p => p.startsWith('v1='))?.slice(3);

  if (!timestamp || !signature) return false;

  // Verify the signature against the payload
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload, 'utf8')
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Express example
app.post('/webhooks/mrrx', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-mrrx-signature'] as string;
  const payload = req.body.toString();

  if (!verifyWebhook(payload, signature, process.env.MRRX_WEBHOOK_SECRET!)) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  const event = JSON.parse(payload);
  // Process event...

  res.json({ received: true });
});

try {
  const session = await mrrx.createSession({
    customer_id: user.stripeCustomerId,
    subscription_id: user.stripeSubscriptionId,
  });

  window.location.href = session.url;
} catch (error) {
  if (error.message.includes('already_exists')) {
    // Session already active, redirect to existing one
  } else if (error.message.includes('already_canceled')) {
    // Show message that subscription is already canceled
  } else {
    // Show generic error, log for investigation
  }
}

Ready to integrate?

Walk through the full setup, end-to-end, in twelve minutes.