v1.0 REST JSON

API Reference

Integrate JustDocIt's SAP migration scanning into your workflows.

Base URL: https://app.justdocit.com/api/v1

Endpoints

Get API Key →

🔑 Authentication

All API requests require an API key passed in the X-API-Key header.

# Include your API key in every request
curl -X POST https://app.justdocit.com/api/v1/scan \
  -H "X-API-Key: your-api-key-here" \
  -F "[email protected]"
💡 Free tier: 10 scans/month with no API key needed. Upgrade to Pro for unlimited API access.
POST /api/v1/scan

Upload an SOP file and get a complete migration analysis with T-code mappings, risk scores, and recommended actions.

Request

Parameter Type Required Description
file File Yes SOP file (PDF, DOCX, TXT, MD, HTML)

Response

{
  "scan_id": "a1b2c3d4",
  "filename": "AP-Invoice-Processing.pdf",
  "risk_score": 78,
  "risk_level": "HIGH",
  "tcodes_found": 12,
  "breaking_changes": 5,
  "details": [
    {
      "tcode": "FK01",
      "description": "Create Vendor (Accounting)",
      "s4_replacement": "BP",
      "change_type": "REPLACED",
      "impact": "BREAKING",
      "fiori_app": "Manage Business Partner"
    }
  ]
}
POST /api/v1/scan-text

Scan raw SOP text content directly without file upload. Perfect for integrating with CMS or content pipelines.

Parameter Type Required Description
text String Yes Raw SOP text content
department String No Department name for categorization
title String No SOP title
POST /api/v1/batch/upload

Upload multiple SOP files at once. Returns a batch ID for tracking progress. Supports up to 50 files per batch.

# Upload multiple files
curl -X POST https://app.justdocit.com/api/v1/batch/upload \
  -H "X-API-Key: your-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]"

Check Batch Status

GET /api/v1/batch/{batch_id}
POST /api/v1/translate

Upload an SOP and receive a fully translated S/4HANA version with all ECC references replaced by their S/4HANA equivalents.

{
  "original_tcodes": 8,
  "translated_tcodes": 6,
  "unchanged": 2,
  "translated_text": "... S/4HANA-ready SOP content ...",
  "change_log": [
    { "from": "FK01", "to": "BP", "context": "Vendor Master → Business Partner" }
  ]
}
GET /api/v1/tcodes

Search the T-code mapping database. Filter by module, change type, or search term. Returns paginated results.

Parameter Type Description
search String Search by T-code or description
module String Filter by SAP module (MM, FI, CO, SD, etc.)
change_type String Filter: REMOVED, REPLACED, MODIFIED, UNCHANGED
limit Integer Results per page (default: 50, max: 200)
POST /api/v1/compare

Upload two SOP versions and get a detailed diff analysis showing what changed between them, with migration impact scoring.

GET /api/v1/report/{scan_id}

Retrieve the full scan report for a previously scanned SOP using its scan ID.

GET /api/v1/breaking-changes

Get a complete list of all breaking T-code changes in S/4HANA — removed transactions, replaced functionality, and required Fiori migrations.

GET /api/v1/analytics/departments

Aggregate migration analytics across departments, including risk distribution, affected SOP counts, and estimated hours.

Related endpoints:

GET /api/v1/analytics/risk-matrix — Risk heatmap by module
GET /api/v1/analytics/tcode-heatmap — Most impacted T-codes

⚡ Rate Limits

Plan Scans/Month Requests/Min Batch Size
Free 10 5 3 files
Pro ($49/mo) Unlimited 60 50 files
Enterprise Unlimited Custom Custom
📊 Response headers: Check X-RateLimit-Remaining and X-RateLimit-Reset to monitor your usage.

🛠️ SDKs & Libraries

Coming soon — official client libraries for popular languages.

🐍
Python
Q2 2026
📦
Node.js
Q2 2026
☕
Java
Q3 2026
🔷
C# / .NET
Q3 2026