{
  "info": {
    "_postman_id": "jonga-ocr-collection-v1",
    "name": "Jonga OCR API",
    "description": "Complete API collection for Jonga OCR — South African Document OCR API. Extract structured data from SA identity documents including Smart IDs, Green Books, Passports, and Driver's Licenses.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://your-domain.vercel.app/api/v1",
      "type": "string"
    },
    {
      "key": "token",
      "value": "jonga_YOUR_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Health Check",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/health",
          "host": ["{{baseUrl}}"],
          "path": ["health"]
        },
        "description": "Health check endpoint. No authentication required. Returns API status, version, database connectivity, and server timestamp."
      },
      "response": []
    },
    {
      "name": "Token Info",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/tokens/me",
          "host": ["{{baseUrl}}"],
          "path": ["tokens", "me"]
        },
        "description": "Retrieve metadata about the authenticated token. Returns scopes, usage statistics, and expiration info."
      },
      "response": []
    },
    {
      "name": "Scan Smart ID Front",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "image",
              "type": "file",
              "src": "",
              "description": "Image of the front of a South African Smart ID card"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/ocr/sa-id-smart-front",
          "host": ["{{baseUrl}}"],
          "path": ["ocr", "sa-id-smart-front"]
        },
        "description": "Extract data from the front of a South African Smart ID card. Returns personal information including name, ID number, date of birth, and citizenship status."
      },
      "response": []
    },
    {
      "name": "Scan Smart ID Back",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "image",
              "type": "file",
              "src": "",
              "description": "Image of the back of a South African Smart ID card"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/ocr/sa-id-smart-back",
          "host": ["{{baseUrl}}"],
          "path": ["ocr", "sa-id-smart-back"]
        },
        "description": "Extract data from the back of a South African Smart ID card. Returns the card number and issue date."
      },
      "response": []
    },
    {
      "name": "Scan Green Book",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "image",
              "type": "file",
              "src": "",
              "description": "Image of a South African Green Book ID biographical page"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/ocr/sa-id-greenbook",
          "host": ["{{baseUrl}}"],
          "path": ["ocr", "sa-id-greenbook"]
        },
        "description": "Extract data from a South African Green Book ID biographical page. Returns personal information and barcode data."
      },
      "response": []
    },
    {
      "name": "Scan Passport (Any Country)",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "image",
              "type": "file",
              "src": "",
              "description": "Image of an international passport biographical page (any country, ICAO Doc 9303 compliant)"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/ocr/passport",
          "host": ["{{baseUrl}}"],
          "path": ["ocr", "passport"]
        },
        "description": "Extract data from an international passport biographical page from ANY country. ICAO Doc 9303 compliant — uses the standardized Machine Readable Zone (MRZ) for reliable cross-country extraction. Returns document type, issuing country (ISO 3166-1 alpha-3), passport number, personal details, MRZ lines, and visual zone fields."
      },
      "response": []
    },
    {
      "name": "Scan Drivers Front",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "image",
              "type": "file",
              "src": "",
              "description": "Image of the front of a South African driver's license"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/ocr/sa-drivers-front",
          "host": ["{{baseUrl}}"],
          "path": ["ocr", "sa-drivers-front"]
        },
        "description": "Extract data from the front of a South African driver's license. Returns personal information, license details, and vehicle codes."
      },
      "response": []
    },
    {
      "name": "Scan Drivers Back",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "image",
              "type": "file",
              "src": "",
              "description": "Image of the back of a South African driver's license"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/ocr/sa-drivers-back",
          "host": ["{{baseUrl}}"],
          "path": ["ocr", "sa-drivers-back"]
        },
        "description": "Extract data from the back of a South African driver's license. Barcode data is encrypted and cannot be decoded."
      },
      "response": []
    }
  ]
}