Documentation

REST API, authenticated with a per-project token. All payloads are JSON, all models are uploaded as binary IFC.

Authentication

curl -H "Authorization: Bearer $BIM_TOKEN" \
     https://api.bim.versioning.org/v1/projects

Upload a model

curl -X POST https://api.bim.versioning.org/v1/projects/42/models \
  -H "Authorization: Bearer $BIM_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @building.ifc

List versions

GET /v1/projects/42/models/{modelId}/versions returns immutable revisions with sha256, author and timestamp.

Webhooks

Events model.uploaded, model.published, issue.created are signed with HMAC-SHA256 in the X-BIM-Signature header.

Limits

ItemLimit
Upload size4 GiB
API rate600 req/min
Concurrent conversions8