{
  "info": {
    "_postman_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "AUROS Protocol v1",
    "description": "The RWA Intelligence Layer — MiCA scoring, RWA catalog, jurisdiction ranking, compliance checklists, and premium monitor/dossier/webhooks.\n\n**Base URL:** `{{baseUrl}}`\n**Auth:** Bearer `{{apiKey}}` (demo: `auros_pk_test_demo`)\n**Free tier:** 100 requests/month\n\n**Rate limit headers:** `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (Unix) on authenticated responses.\n\nImport via URL: `https://getauros.com/auros-postman.json`\nDocs: https://getauros.com/developers",
    "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://getauros.com"
    },
    {
      "key": "apiKey",
      "value": "auros_pk_test_demo"
    },
    {
      "key": "scoreId",
      "value": ""
    },
    {
      "key": "monitorId",
      "value": ""
    },
    {
      "key": "webhookId",
      "value": ""
    },
    {
      "key": "deliveryId",
      "value": ""
    },
    {
      "key": "regulatorySubId",
      "value": ""
    },
    {
      "key": "dossierToken",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "Status",
      "item": [
        {
          "name": "GET /api/v1/status",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/v1/status",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "status"]
            },
            "description": "Public health check — probes scoring engine, product catalog, jurisdiction ranking, and key storage. No authentication required."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Intelligence",
      "item": [
        {
          "name": "POST /api/v1/score (free-text)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"description\": \"Entrepôt retail Luxembourg €2.5M SPV investisseurs professionnels whitepaper brouillon\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/score",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "score"]
            },
            "description": "Compute an indicative MiCA readiness score (0–100) from free-text description."
          },
          "response": []
        },
        {
          "name": "POST /api/v1/score (structured)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"asset_type\": \"real_estate\",\n  \"issuer_type\": \"company_spv\",\n  \"investor_type\": \"professional\",\n  \"whitepaper\": \"draft\",\n  \"jurisdiction\": \"luxembourg\",\n  \"value_eur\": 2500000,\n  \"has_kyc\": true,\n  \"has_data_room\": false\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/score",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "score"]
            },
            "description": "Compute MiCA score from structured compliance fields."
          },
          "response": []
        },
        {
          "name": "POST /api/v1/score/batch",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"record_history\": true,\n  \"items\": [\n    {\n      \"description\": \"Retail warehouse Luxembourg €2.5M SPV professional investors\"\n    },\n    {\n      \"asset_type\": \"bonds\",\n      \"issuer_type\": \"company_spv\",\n      \"whitepaper\": \"draft\",\n      \"has_kyc\": true\n    }\n  ]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/score/batch",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "score", "batch"]
            },
            "description": "Score up to 20 assets in one call. Partial success per item. Counts as 1 quota unit (not N items). Each successful item includes score_id."
          },
          "response": []
        },
        {
          "name": "GET /api/v1/score/{id}/history",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/v1/score/{{scoreId}}/history",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "score", "{{scoreId}}", "history"]
            },
            "description": "Historical score snapshots for a session (`scr_…` from POST /score) or premium monitor (`mon_…`). Set `scoreId` collection variable after scoring."
          },
          "response": []
        },
        {
          "name": "GET /api/v1/jurisdictions",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/v1/jurisdictions?asset_type=real_estate&investor_type=professional&timeline_months=6",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "jurisdictions"],
              "query": [
                {
                  "key": "asset_type",
                  "value": "real_estate",
                  "description": "real_estate | bonds | private_credit | funds | all"
                },
                {
                  "key": "investor_type",
                  "value": "professional",
                  "description": "professional | retail | mixed | all"
                },
                {
                  "key": "timeline_months",
                  "value": "6",
                  "description": "1–36"
                },
                {
                  "key": "budget",
                  "value": "",
                  "description": "Budget in EUR",
                  "disabled": true
                }
              ]
            },
            "description": "Rank regulatory jurisdictions by asset type, investor profile, timeline, and budget."
          },
          "response": []
        },
        {
          "name": "POST /api/v1/checklist",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"asset_type\": \"real_estate\",\n  \"jurisdiction\": \"luxembourg\",\n  \"structure\": \"spv\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/checklist",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "checklist"]
            },
            "description": "Generate 20+ compliance items for an asset type, jurisdiction, and legal structure."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Catalog",
      "item": [
        {
          "name": "GET /api/v1/products",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/v1/products?category=bonds&yield_min=4&limit=10",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "products"],
              "query": [
                {
                  "key": "category",
                  "value": "bonds",
                  "description": "stablecoins | real_estate | bonds | commodities | private_credit | all"
                },
                {
                  "key": "jurisdiction",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "chain",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "yield_min",
                  "value": "4"
                },
                {
                  "key": "yield_max",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "1",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "sort",
                  "value": "apy",
                  "description": "apy | tvl | name",
                  "disabled": true
                }
              ]
            },
            "description": "Paginated catalog of 120+ tokenized RWA products with APY, TVL, chains, and jurisdiction."
          },
          "response": []
        },
        {
          "name": "GET /api/v1/benchmarks",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/v1/benchmarks?category=bonds&jurisdiction=EU",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "benchmarks"],
              "query": [
                {
                  "key": "category",
                  "value": "bonds",
                  "description": "bonds | stablecoins | real_estate | private_credit | commodities (required)"
                },
                {
                  "key": "jurisdiction",
                  "value": "EU",
                  "description": "Optional partial jurisdiction filter (EU, US, CH, …)"
                }
              ]
            },
            "description": "Sector benchmarks — median APY, P25/P75 quartiles, product count from /compare hub (static fallback if sparse)."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Compare",
      "item": [
        {
          "name": "POST /api/v1/compare (by product IDs)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"product_ids\": [\"maple-usdc\", \"realt-portfolio\", \"backed-bib01\"]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/compare",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "compare"]
            },
            "description": "Compare 2–4 products side-by-side by explicit IDs — mirrors the /compare hub panel."
          },
          "response": []
        },
        {
          "name": "POST /api/v1/compare (by filter)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"category\": \"bonds\",\n  \"yield_min\": 4,\n  \"risk_tier\": \"core\",\n  \"limit\": 3\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/compare",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "compare"]
            },
            "description": "Select top matching products by category, yield, risk tier, and jurisdiction (2–4 results, sorted by APY)."
          },
          "response": []
        }
      ]
    },
      "item": [
        {
          "name": "POST /api/v1/keys",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"developpeur@entreprise.com\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/api/v1/keys",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "keys"]
            },
            "description": "Request a free-tier API key (100 requests/month). No authentication required. The raw key is returned once — store securely."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Premium",
      "description": "Requires `auros_pk_live_*` or premium tier. Demo key returns HTTP 403 premium_required.",
      "item": [
        {
          "name": "Monitor",
          "item": [
            {
              "name": "POST /api/v1/monitor",
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"asset_type\": \"real_estate\",\n  \"jurisdiction\": \"luxembourg\",\n  \"structure\": \"spv\",\n  \"webhook_url\": \"https://your.app/hooks/auros\",\n  \"alert_on\": [\"score_change\", \"regulation_update\", \"deadline_approaching\"]\n}"
                },
                "url": {
                  "raw": "{{baseUrl}}/api/v1/monitor",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "monitor"]
                },
                "description": "Register an asset profile for regulatory monitoring. Save `id` from response to `monitorId` variable."
              },
              "response": []
            },
            {
              "name": "GET /api/v1/monitor/:id",
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/monitor/{{monitorId}}",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "monitor", "{{monitorId}}"]
                },
                "description": "Get monitor status, last check, and last alert."
              },
              "response": []
            },
            {
              "name": "DELETE /api/v1/monitor/:id",
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/monitor/{{monitorId}}",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "monitor", "{{monitorId}}"]
                },
                "description": "Delete (unregister) a monitor."
              },
              "response": []
            }
          ]
        },
        {
          "name": "Dossier",
          "item": [
            {
              "name": "POST /api/v1/dossier",
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"score\": {\n    \"description\": \"Entrepôt retail Luxembourg €2.5M SPV professionnels\",\n    \"asset_type\": \"real_estate\"\n  },\n  \"format\": \"pdf\",\n  \"sections\": [\"executive_summary\", \"score_breakdown\", \"checklist\", \"disclaimers\"],\n  \"branding\": { \"company_name\": \"Ma Société\" }\n}"
                },
                "url": {
                  "raw": "{{baseUrl}}/api/v1/dossier",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "dossier"]
                },
                "description": "Generate institutional MiCA readiness report. PDF response includes `download_url` — extract token to `dossierToken`."
              },
              "response": []
            },
            {
              "name": "GET /api/v1/dossier/pdf",
              "request": {
                "auth": {
                  "type": "noauth"
                },
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/dossier/pdf?token={{dossierToken}}",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "dossier", "pdf"],
                  "query": [
                    {
                      "key": "token",
                      "value": "{{dossierToken}}",
                      "description": "HMAC-signed token from POST /api/v1/dossier download_url (valid 24h)"
                    }
                  ]
                },
                "description": "Download dossier PDF using HMAC-signed token from POST /api/v1/dossier response. No Bearer auth — token query param only."
              },
              "response": []
            }
          ]
        },
        {
          "name": "Regulatory Feed",
          "item": [
            {
              "name": "GET /api/v1/regulatory/feed",
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/regulatory/feed?jurisdiction=france&tag=amf&limit=10",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "regulatory", "feed"],
                  "query": [
                    { "key": "jurisdiction", "value": "france" },
                    { "key": "tag", "value": "amf" },
                    { "key": "limit", "value": "10" }
                  ]
                },
                "description": "Curated ESMA/AMF/BaFin regulatory feed (premium). v1 static seed — v2 live polling."
              },
              "response": []
            },
            {
              "name": "POST /api/v1/regulatory/subscribe",
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"jurisdictions\": [\"france\", \"eu\"],\n  \"tags\": [\"amf\", \"mica\"],\n  \"webhook_url\": \"https://your.app/hooks/auros-regulatory\"\n}"
                },
                "url": {
                  "raw": "{{baseUrl}}/api/v1/regulatory/subscribe",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "regulatory", "subscribe"]
                },
                "description": "Subscribe to regulatory.update webhook alerts. Save `id` to `regulatorySubId`."
              },
              "response": []
            },
            {
              "name": "GET /api/v1/regulatory/subscribe/:id",
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/regulatory/subscribe/{{regulatorySubId}}",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "regulatory", "subscribe", "{{regulatorySubId}}"]
                },
                "description": "Get regulatory feed subscription status."
              },
              "response": []
            },
            {
              "name": "DELETE /api/v1/regulatory/subscribe/:id",
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/regulatory/subscribe/{{regulatorySubId}}",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "regulatory", "subscribe", "{{regulatorySubId}}"]
                },
                "description": "Delete regulatory feed subscription."
              },
              "response": []
            }
          ]
        },
        {
          "name": "Webhooks",
          "item": [
            {
              "name": "POST /api/v1/webhooks",
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"url\": \"https://your.app/hooks/auros\",\n  \"events\": [\"regulation_update\", \"new_requirement\", \"regulatory.update\"]\n}"
                },
                "url": {
                  "raw": "{{baseUrl}}/api/v1/webhooks",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "webhooks"]
                },
                "description": "Register a webhook endpoint for HMAC-signed alerts. Save `id` to `webhookId` variable."
              },
              "response": []
            },
            {
              "name": "GET /api/v1/webhooks",
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/webhooks",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "webhooks"]
                },
                "description": "List registered webhooks for the current API key."
              },
              "response": []
            },
            {
              "name": "DELETE /api/v1/webhooks/:id",
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/webhooks/{{webhookId}}",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "webhooks", "{{webhookId}}"]
                },
                "description": "Delete a registered webhook."
              },
              "response": []
            },
            {
              "name": "GET /api/v1/webhooks/:id/deliveries",
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/webhooks/{{webhookId}}/deliveries?limit=20&offset=0",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "webhooks", "{{webhookId}}", "deliveries"],
                  "query": [
                    { "key": "limit", "value": "20" },
                    { "key": "offset", "value": "0" }
                  ]
                },
                "description": "Paginated webhook delivery log (pending, delivered, failed, dead_letter)."
              },
              "response": []
            },
            {
              "name": "POST /api/v1/webhooks/:id/replay",
              "request": {
                "method": "POST",
                "header": [
                  { "key": "Content-Type", "value": "application/json" }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"delivery_id\": \"{{deliveryId}}\"\n}"
                },
                "url": {
                  "raw": "{{baseUrl}}/api/v1/webhooks/{{webhookId}}/replay",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "webhooks", "{{webhookId}}", "replay"]
                },
                "description": "Replay dead-letter deliveries. Omit delivery_id in body to replay all dead_letter for the webhook."
              },
              "response": []
            },
            {
              "name": "POST /api/v1/webhooks/deliveries/:delivery_id/replay",
              "request": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/api/v1/webhooks/deliveries/{{deliveryId}}/replay",
                  "host": ["{{baseUrl}}"],
                  "path": ["api", "v1", "webhooks", "deliveries", "{{deliveryId}}", "replay"]
                },
                "description": "Replay a single delivery by ID."
              },
              "response": []
            }
          ]
        }
      ]
    }
  ]
}