{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"6fd59f93-29c4-44d8-bd59-81309fd1f27d","name":"StatuteIQ Engine API (Preliminary)","description":"<div align=\"center\"><img src=\"https://storage.googleapis.com/brownsville-web-prod-site/assets/img/logo.png\" alt=\"Brownsville Advisory\" width=\"600\"></div>\n\n# StatuteIQ Engine API\n### The Intelligent Compliance Engine, by Brownsville Advisory\n\n> *Navigate the complex world of compliance with confidence.*\n\n**Status: Preliminary — gated developer reference.** This documents the StatuteIQ engine's current and designed HTTP surface. It is shared with approved evaluating teams and customers (request access via brownsvilleadvisory.com); it is **not a GA contract** — paths, schemas, and external auth are still being finalized. Build-state is marked per request: **LIVE** (deployed today) vs **DESIGNED** (specified in ENG-1, not yet built).\n\n*Last refreshed: 2026-06-26.*\n\n---\n\n## What this is\nThe **API service model** is direct programmatic access to the StatuteIQ **Compliance & Risk engine** — custom-trained reasoning hosted on Google Vertex AI. It returns **grounded, cited, schema-validated** results, and it **refuses to answer when evidence is insufficient** rather than fabricating one. The engine also fronts the **MCP estate** (an `mcp-handler` plus per-domain MCP servers — acquisition, compliance, FedRAMP, policy-directive, quantum-auth); MCP clients reach those tools through the same grounded, fail-closed contract described below.\n\n## Quick start\n1. The collection's `baseUrl` is set to the live Cloud Run engine. (Override it via an Environment for local testing.)\n2. Set `access_token`. Today the engine is behind a Google OIDC **identity-token bearer** (for local testing: `gcloud auth print-identity-token`). External customer auth is TBD.\n3. Send a request, or run the **Workflows** folder to exercise the `retrieve -> reason` chain.\n\n## Folders\n| Folder | Surface |\n|---|---|\n| **Tools (LIVE)** | The deployed tool surface: `/tools/list`, `/tools/invoke`, `/tools/classify`. |\n| **RAG API (DESIGNED)** | `/api/retrieve` and `/api/reason` per ENG-1; lights up once the Knowledge Pool corpus loads. |\n| **Workflows (DESIGNED)** | The canonical `retrieve -> reason` flow, with evidence passed between steps. |\n\n## The grounding & fail-closed rule\nWhen evidence is empty or insufficient, the engine does **not** synthesize an answer. `/tools/invoke` returns a fail-closed result — a `disposition`, `citable:false`, and a `degradationReason` (e.g. `corpus_pending`) — rather than fabricated clause text, award IDs, or docket numbers. RAG reasoning returns `grounded:false` with empty result and empty citations. Always surface the returned citations and the pinned `version` to end users; that provenance is the product's core value.\n\n---\n*Brownsville Advisory LLC · Washington, D.C. Metro Area · contact@brownsvilleadvisory.com*\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"56010874","team":18655694,"collectionId":"6fd59f93-29c4-44d8-bd59-81309fd1f27d","publishedId":"2sBXwvHTsd","public":true,"publicUrl":"https://docs.statuteiq.io","privateUrl":"https://go.postman.co/documentation/56010874-6fd59f93-29c4-44d8-bd59-81309fd1f27d","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"2E5FA3"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Programmatic access to StatuteIQ, Brownsville Advisory's custom-trained federal compliance and risk engine. Responses are grounded in retrieved evidence, cited to a pinned source version, and schema-validated. The engine refuses to answer when evidence is insufficient instead of fabricating one."},{"name":"title","value":"StatuteIQ Engine API: Grounded Federal Compliance and Risk | Brownsville Advisory"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/90224d66-af0c-4422-aed3-ea27ca0680e2/ZWRnZS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"2E5FA3"}},{"name":"light","logo":"https://content.pstmn.io/dc88fb08-8c85-43b9-96fa-46a9830b334e/bG9nby5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"2E5FA3"}}]}},"version":"8.12.3","publishDate":"2026-06-27T19:22:07.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"StatuteIQ Engine API: Grounded Federal Compliance and Risk | Brownsville Advisory","description":"Programmatic access to StatuteIQ, Brownsville Advisory's custom-trained federal compliance and risk engine. Responses are grounded in retrieved evidence, cited to a pinned source version, and schema-validated. The engine refuses to answer when evidence is insufficient instead of fabricating one."},"logos":{"logoLight":"https://content.pstmn.io/dc88fb08-8c85-43b9-96fa-46a9830b334e/bG9nby5wbmc=","logoDark":"https://content.pstmn.io/90224d66-af0c-4422-aed3-ea27ca0680e2/ZWRnZS5wbmc="}},"statusCode":200},"environments":[{"name":"StatuteIQ - Cloud Run (us-east4)","id":"6c66c9db-2f32-4687-aab4-f15df6fa541b","owner":"56010874","values":[{"key":"baseUrl","value":"https://statuteiq-engine-qbvqlpapma-uk.a.run.app","enabled":true,"type":"default"},{"key":"access_token","value":"","enabled":true,"type":"secret"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/19794afb9fc29ae6d913d20edcd94aa96fd7a3035892e44a9e32e42e41dc21b9","favicon":"https://statuteiq.io/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"StatuteIQ - Cloud Run (us-east4)","value":"56010874-6c66c9db-2f32-4687-aab4-f15df6fa541b"}],"canonicalUrl":"https://docs.statuteiq.io/view/metadata/2sBXwvHTsd"}