No Subscription

{
  "type": "https://scan-documents.com/docs/errors/no-subscription",
  "title": "No Subscription",
  "status": 409,
  "message": "User does not have an active subscription"
}

# Check your current usage and limits
curl -X GET https://api.scan-documents.com/v1/account/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

// Example: Check if subscription is active before making requests
const checkSubscription = async () => {
  try {
    const response = await fetch('https://api.scan-documents.com/v1/account', {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    });

    const account = await response.json();

    if (!account.subscription.active) {
      console.log('Please upgrade your subscription to continue');
      // Redirect to billing page
    }
  } catch (error) {
    if (error.status === 409) {
      // Handle no subscription error
    }
  }
};

# Trying to use OCR (premium feature) without subscription
curl -X POST https://api.scan-documents.com/v1/image-operations/extract-text \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "input=file_abc123"

{
  "type": "https://scan-documents.com/docs/errors/no-subscription",
  "title": "No Subscription",
  "status": 409,
  "message": "User does not have an active subscription"
}

# 101st API call in the month (exceeding free tier limit)
curl -X POST https://api.scan-documents.com/v1/image-operations/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "input=file_xyz789" \
  -F "format=pdf"

{
  "type": "https://scan-documents.com/docs/errors/no-subscription",
  "title": "No Subscription",
  "status": 409,
  "message": "User does not have an active subscription. You have exceeded your free tier limit of 100 API calls per month."
}

const getUsage = async () => {
  const response = await fetch('https://api.scan-documents.com/v1/account/usage', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });

  const usage = await response.json();
  console.log(`Used ${usage.calls} of ${usage.limit} API calls this month`);

  // Alert when approaching limit
  if (usage.calls >= usage.limit * 0.9) {
    console.warn('Approaching API call limit!');
  }
};

async function processDocument(fileId) {
  try {
    return await performPremiumOperation(fileId);
  } catch (error) {
    if (error.status === 409) {
      // Fall back to basic operation or prompt user to upgrade
      return showUpgradePrompt();
    }
    throw error;
  }
}