{
  "info": {
    "_postman_id": "dike-mena-legal-api-v1",
    "name": "Dike MENA Legal API",
    "description": "Official Postman Collection for Dike's MENA Legal Data & AI Grounding API. Covers primary legal sources across Saudi Arabia, the UAE, and Egypt with deterministic citation resolution.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.dike.it.com",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "YOUR_DIKE_API_KEY",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Search & Retrieval",
      "description": "Hybrid semantic + lexical search over MENA legal corpora with optional cross-encoder reranking.",
      "item": [
        {
          "name": "Hybrid Legal Search",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"query\": \"مسؤولية الناقل الجوي عن تأخير الرحلات\",\n  \"top_k\": 10,\n  \"filters\": {\n    \"doc_type\": [\"legislation\", \"case_law\"],\n    \"jurisdiction\": \"EG\",\n    \"year_from\": 1990,\n    \"status\": [\"in_force\"]\n  },\n  \"rerank\": true,\n  \"include_text\": true\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/search",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "search"]
            },
            "description": "Perform hybrid search across 1.44M+ primary legal sources with multi-jurisdiction filters."
          }
        }
      ]
    },
    {
      "name": "Grounded Reasoning",
      "description": "Grounded legal Q&A with a hallucination guard: every citation is verified against the retrieved source set before being returned. Requires a Pay As You Go plan.",
      "item": [
        {
          "name": "Grounded Legal Reasoning",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"question\": \"ما هي شروط فسخ العقد في نظام المعاملات المدنية السعودي؟\",\n  \"filters\": {\n    \"jurisdiction\": \"SA\"\n  },\n  \"top_k\": 12,\n  \"language\": \"ar\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/reason",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "reason"]
            },
            "description": "Extract verified statutory rules without generative hallucinations. Citations are always verified server-side; there is no opt-out flag. Requires a Pay As You Go plan (403 plan_required on Free)."
          }
        }
      ]
    },
    {
      "name": "Citation Resolver",
      "description": "Parse and resolve an Arabic legal citation string to its canonical source document.",
      "item": [
        {
          "name": "Resolve Citation Anchor",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"citation\": \"المادة 107 من نظام المعاملات المدنية\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/cite",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "cite"]
            },
            "description": "Resolves citation text back to the official gazette publication. Jurisdiction is inferred from the citation text itself, not passed separately."
          }
        }
      ]
    },
    {
      "name": "Legal Graph Traversal",
      "description": "Traverse legal hierarchy, amendments, repeals, and executive regulations.",
      "item": [
        {
          "name": "Traverse Citation Graph",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"canonical_id\": \"eg-leg-1948-131\",\n  \"direction\": \"in\",\n  \"edge_types\": [\"cites\", \"amends\"],\n  \"depth\": 1,\n  \"limit\": 100\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/graph/traverse",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "graph", "traverse"]
            },
            "description": "Retrieve connecting regulations, amendments, and citing documents. Depth is capped at 3."
          }
        }
      ]
    },
    {
      "name": "System & Health",
      "description": "Service discovery and health status.",
      "item": [
        {
          "name": "List Supported Jurisdictions",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/v1/jurisdictions",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "jurisdictions"]
            },
            "description": "List all currently indexed MENA jurisdictions and their coverage."
          }
        },
        {
          "name": "Health Status",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/healthz",
              "host": ["{{baseUrl}}"],
              "path": ["healthz"]
            },
            "description": "Liveness probe. Unauthenticated, not under /v1."
          }
        }
      ]
    }
  ]
}