API Overview - BIM Engine

Structured JSON API for integrating BIM Engine with your permitting systems, internal tools, or AI agents. Copy this entire reference into your coding agent to build integrations.

Base URL

https://gov.bimengine.ai/api/gov

Authentication

All requests require a valid session cookie. Authenticate through the same mechanism as the web portal.

Endpoints

Method	Path	Description
`GET`	`/api/gov/dashboard`	Dashboard stats and recent submissions
`GET`	`/api/gov/submissions`	List submissions with filters
`GET`	`/api/gov/submissions/:reviewId`	Submission detail with compliance items
`PATCH`	`/api/gov/submissions/:reviewId`	Update status or assignment
`POST`	`/api/gov/submissions/:reviewId/actions`	Record review action on a compliance item
`POST`	`/api/gov/submissions/:reviewId/complete`	Finalize a review
`GET`	`/api/gov/codes`	List code editions
`GET`	`/api/gov/codes/:editionId`	Code edition detail
`GET`	`/api/gov/inspections`	List inspections
`GET`	`/api/gov/jurisdiction`	Jurisdiction profile
`GET`	`/api/gov/analytics`	Analytics data

Status enums

Submission status

PENDING | IN_REVIEW | APPROVED | REJECTED | NEEDS_RESPONSE

Review action

APPROVE | FLAG | REJECT | SKIP

AI verdict

GREEN (passing) | YELLOW (needs review) | RED (failing)